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Limited Warranty 
eee 


IDEA, Inc., guarantees this IDEA Product to be in 
good working order for a period of 1 year from the 
date of purchase from IDEA or an authorized 
IDEA dealer. If this Product fails to be in good 
working order at any time during this one year 
warranty period, IDEA will, at its option, repair or 
replace this product at no additional charge except 
as set forth below. Repair parts and replacement 
products will be furnished on an exchange basis 
and will be either reconditioned or new. All 
replaced parts and products become the property of 
IDEA. This limited warranty does not include 
service to repair damages to the product resulting 
from accident, disaster, misuse, abuse, or 
non-IDEA modification of the product. 


Limited Warranty service can be obtained by 
delivering the product during the one year warranty 
period to an authorized IDEA dealer or by sending 
the product to IDEA. IDEA will not accept 
products without a Materials Return Authorization 
(MRA) number issued by its Customer Support 
Department, with a proof of purchase date. If this 
product is delivered to IDEA by mail, you agree to 
insure the product or assume risk of loss or damage 
in transit, to prepay shipping charges to the 
warranty service location and to use the original 
shipping container or equivalent. 


ALL EXPRESS AND IMPLIED WARRANTIES 
FOR THIS PRODUCT INCLUDING THE 
WARRANTIES OF MERCHANTABILITY AND 
FITNESS FOR A PARTICULAR PURPOSE, ARE 
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LIMITED IN DURATION TO A PERIOD OF 1 YEAR 
FROM THE DATE OF PURCHASE, AND NO 
WARRANTIES, WHETHER EXPRESS OR IMPLIED, 
WILL APPLY AFTER THIS PERIOD. SOME 
STATES DO NOT ALLOW LIMITATIONS ON HOW 
LONG AN IMPLIED WARRANTY LASTS, SO THE 
ABOVE LIMITATIONS MAY NOT APPLY TO YOU. 


IF THIS PRODUCT IS NOT IN GOOD WORKING 
ORDER AS WARRANTED ABOVE, YOUR SOLE 
REMEDY SHALL BE REPAIR OR REPLACEMENT 
AS PROVIDED ABOVE. IN NO EVENT WILL IDEA 
BE LIABLE TO YOU FOR ANY DAMAGES, 
INCLUDING ANY LOST PROFITS, LOST SAVINGS 
OR OTHER INCIDENTAL OR CONSEQUENTIAL 
DAMAGES ARISING OUT OF THE USE OF OR 
INABILITY TO USE SUCH PRODUCT, EVEN IF 
IDEA OR AN AUTHORIZED IDEA PERSONAL 
COMPUTER DEALER HAS BEEN ADVISED OF 
THE POSSIBILITY OF SUCH DAMAGES, OR FOR 
ANY CLAIM BY ANY OTHER PARTY. 


SOME STATES DO NOT ALLOW THE EXCLUSION 
OR LIMITATION OF INCIDENTAL OR 
CONSEQUENTIAL DAMAGES FOR CONSUMER 
PRODUCTS, SO THE ABOVE LIMITATIONS OR 
EXCLUSIONS MAY NOT APPLY TO YOU. 


THIS WARRANTY GIVES YOU SPECIFIC LEGAL 
RIGHTS, AND YOU MAY ALSO HAVE OTHER 
RIGHTS WHICH MAY VARY FROM STATE T 
STATE. . 


To obtain Limited Warranty coverage, you must 
complete and return the enclosed Warranty Card. 


Information on warranty service is in the appendix on 
Customer Support at the end of this manual. 
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Customer Survey Form 


Product: [DEAcomm 
5251/Plus Software Guide 
Rev. 7 


1. 


Were there any errors in the manual? If yes, 
list page numbers and kind of error: 


Was information: 

easy to understand 

difficult 

List information that was hard to find: 


Was information: 
complete 
incomplete 


What features of the product did you 
particularly like? 


What features would you like to see added to 
the product in future revisions? 


NO POSTAGE 
NECESSARY IF 
MAILED IN 


THE UNITED 
STATES 


BUSINESS REPLY MAIL 


FIRST CLASS PERMIT NO.50 BILLERICA, MA 


Postage will be paid by addressee 


IDEA, Inc. 
29 Dunham Road 
Billerica, MA 01821-9947 


Attn: Documentation Dept. 


Fold back here and tape —- do NOT use staples 


6. Compared to similar manuals, how would you 
rate the documentation? 
Better than most 
Average 
Worse than most 
7. Please rate your knowledge of personal 
computers: 
Experienced 
Some previous use 
First-time user 


8. Please use the rest of this page for additional 
comments. 


Optional: Name 
Phone 
Address 


Notice 


Copyright 
Copyright ©1989 by IDEA, Inc. All rights 


reserved. 


Trademarks 


IDEAcomm 5251/Plus is a registered trademark of 
IDEA, Inc. in the United States of America. 


IBM, PC Organizer, PC Support/36, PC 
Support/38, Personal System/2, and Micro Channel 
are trademarks of International Business Machines. 


Section I: 
Introduction 


Overview of IDEAcomm 


The IDEA TWINAX emulation software works with 
the IDEAcomm 5251/Plus card to link the IBM PC 
or PS/2 series to an IBM System 34/36/38 or 
AS/400 minicomputer or to the IBM 5294 or 5394 
or IBM 5251 Model 12 remote controllers via an 
IBM twinaxial cable. The package provides 
emulation of system terminals and printers. 


Features and Benefits 


The IDEA communications system provides the 
following features: 


@ The ability to configure 7 LUs or host sessions 
@ Support of a maximum of 3 printer LUs 


@® Emulation of the following terminal types: 
— IBM 5251 display station, model 11 
— IBM 5291 display station 
— IBM 5292 display station, model 1 
—— IBM 5292 display station, model 2 
— IBM 3180 display station, model 2 
— IBM 3196 display station 


@ Emulation of the following printer types: 
— IBM 5224/25 printer, model 1 
—— IBM 5256 printer, model 1 
——- IBM 5219 printer 
—- IBM 4214-2 printer 


@ The ability to print graphics from 5292 Model 2 
emulation screens on your local PC color 
graphics printer 
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® Windowing feature that allows you to: 


— view multiple sessions at one time 
—— turn windows ON or OFF 
— change the size of the windows displayed 


@ The SEND utility to send and receive 
commands between the PC and host 
automatically (especially startup commands) 


@ kKYEDIT keyboard remapping program 
@ IDEAlink bidirectional file transfer software 


® Compatibility with IBM’s PC Support/36 
(5727-WSI) and PC Support/38 (5714—PC1) 
on the System 3X 


@ Support for both the IBM monochrome and 
color display adapters as well as the 
IDEAcomm 5251 D card 


@ Compatibility with many third party file transfer 
packages 


@ Low level program interface (API) 
documentation that allows you to tailor 
applications to the IBM midrange 


@ Hot Key to toggle between DOS and host 
sessions (including batch files) without logging 
off the host 

@ Advanced error detection and recovery features 


@ Diagnostics 


@ One year limited warranty 
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Inventory Checklist 


INSTALL card 

IDEAcomm 5251/Plus Software Guide 
IDEAlink PC User’s Manual 
Keyboard templates 

Software diskettes, 3.5” and 5.25” 


Order form for host IDEAlink software and 
manual 


Warranty Card 


A Note for Users of 
IDEAcomm 5251 (4 LUs) 


The IDEAcomm diskettes include the files 
TWINAX4.UCM and TWINAX4.MI for your 
product. In general, the IDEA software knows 
which files to use. In case of unusual hardware or 
software messages, be sure that the TWINAX4.xx 
files are in the directory where you will use 
TWINAX, and delete the TWINAX7.xx files. 
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Organization and Scope of the 
Manuals 


This manual is the basic reference for the 
IDEAcomm 5251/Plus software communications 
packages, including configuration of the software 
and how to use emulation and file transfer. The 
appendixes include troubleshooting hints. 


Related IDEA Publications 


The IDEAlink PC User’s Manual is included in this 
software package. It explains how to use the 
IDEAlink file transfer software. 


The IDEAlink Host Operations Guide comes with 
the free IDEAlink host software package that you 
can order with the form included in the present 
package. 


The IDEAcomm 5251/Plus Hardware Installation 
Guide is shipped with packages that include the 
§251/Plus card, the AS/400 PC Support driver, and 
other hardware. 


The IDEAcomm 5251/Plus Technical Reference is 
available free to customers who return the card at 
the end of this section. It has information on the 
IDEA and IBM applications programming interfaces 
and IDEA support of IBM printer commands. 


Related IBM Publications 
System/34 

IBM System/34 Installation and Modification 
Reference Manual (SC21-7689) 


5250 Information Display System to System/34 
System Unit Product Attachment Information 


System/36 


IBM System/36 Systems Reference Manual 
(SC21-9020) 
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IBM System/36 Changing Your System 
Configuration (SC21-9052) 


5250 Information Display System to System/38 
System Unit Product Attachment Information 


System/38 


IBM System/38 Guide to Program Product 
Installation and Device Configuration (GC21-7775) 


5250 Information Display System to System/38 
System Unit Product Attachment Information 


AS/400 


AS/400 System Operations Operator’s Guide 
(SC-—8082-0) 


AS/400 Device Configuration Guide (SC21-8106-0) 


AS/400 Programming Command Reference 
Summary (SC21-8076-1) 


Introduction 1-5 


Notation Conventions 


PC 
TWINAX 


System 3X 
Host 


UPPERCASE 


lowercase 


pathname 


<Enter> 


[J 


Refers to an IBM PC, XT, AT, or 
PS/2 Model 30. 


The name of the IDEAcomm 
5251/Plus emulation program. 


The IBM System/34, /36, and /38. 
The IBM 3X or AS/400. 


Information in upper case must be 
entered as shown. It can be 
entered in upper or lower case, but 
is displayed on the screen in upper 
case. 


Fields in lower case indicate 
variable information. 


A standard DOS file specification of 
the form: 
[ drive: ][directory\ ]filename[.ext]. 


Press the Enter key. 


Square brackets indicate optional 
fields. The square brackets should 
not be entered. 


One of the items must be entered 
unless the items are also surrounded 
by square brackets. 


Documentation Updates 


Enhancements or corrections to the documentation 
are in the READ.ME file on your software diskette. 


A list of the files included with each software 
release is in the file VERSION.DOC. 


1-6 Introduction 


Please send me a copy of the JDEAcomm 
5251/Plus Technical Reference Guide. 


My serial number is: 

Company: 

Name: 

Address: 

City/State/Zip: 

Software version #: 

Phone Number: 

From whom purchased: 
Company: 
City/State: 

What is your midrange system: 


S/34 S/36 S/38 AS/400___ 
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IDEA, Inc. 

29 Dunham Road 
Billerica, MA 01821-9947 
U.S.A. 


Attn: Documentation Dept. 


Fold back here and tape —- do NOT use staples 
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Section II: 
Basic Configuration 


Before you use the TWINAX emulation program, 
you or the system administrator must run either the 
INSTALL or the IDEACFIG configuration program 
described in this section. These programs allow 
you to select the displays and printers you want to 
emulate. If your software has already been 
configured, go to Section ITI. 


IMPORTANT 


Before you use the software, make a 
backup copy of the IDEAcomm diskettes if 
you have not already done so. Use the 
DOS DISKCOPY command. Put the 
Original diskettes away for safekeeping and 
use the backup copy. 


If you are making a backup copy that 
overwrites a version of IDEAcomm lower 
than 5.0, you must delete or rename 
TWINDIAG.COM from the old version. 
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Running INSTALL 


The INSTALL program provides a fast, easy 
method of configuring IDEAcomm for your 
microcomputer. If you have a standard IBM 
display adapter and a printer listed on the following 
page, INSTALL is the only program you need to 
run before you use IDEAcomm. 


To use the INSTALL program, you need 
information from your host configuration. Before 
you begin, make sure that you know the following 
for each host session you want to install: 


@ Device type (model number):- For the model 
of display or printer, TWINAX offers the 
following options: 


$251 model 11 5224 model 1 
$291 5225 model 1 
5292 model 1 5256 model 1 
5292 model 2 (graphics display)} 5219 — word processing 
3196 4214 model 2 — landscape and | 
3180 model 2 (wide screen) multibin options 


@ Station address (0 to 6). Note that, if the 
IDEAcomm card is connected to the host, 
INSTALL checks the station addresses 
currently in use and will not use those. 


@® Whether it will use a file transfer package (only 
on the 4 LU IDEAcomm/5251). 


@ The keyboard language you will use and the 
layout (IBM 5250 emulation or PC style 
emulation). See the templates accompanying 
this manual. 
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What drive and pathname you will use to run 
emulation (for example, C:\ TWINAX). You 
must create any sub-directory before running 
INSTALL. 


Model of your PC printer if you are using one. 


Note 


The term PC printer refers to your local 
printer attached to your PC or PS/2. 


PC Printers supported in Release 5.2 
(consult the READ.ME file or run 
INSTALL for higher versions): 


'12NEC 3550 Spinwriter 

12TIBM 5216 Wheelprinter 

12HP LaserJet 

2Okidata Microline 84 

2IBM Color Printer 

12IBM Quietwriter 

2IBM Proprinter 

12Epson FX-286e “‘IBM Emulation mode”’ 
2Epson LQ-1000 

2Fujitsu DL2400 


Suitable for 5219 printer emulation. 
2 Suitable for 4214, 5224, and 5225 
emulation. 


If your printer is not listed, use IDEACFIG 
to define it. 


PC printer type (serial or parallel) if any. 


PC printer port, if any (LPT1, COM1, and so 
on.) 
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Install your hardware and software with the 
following steps: 


1. Install the IDEAcomm card in the PC or PS/2 
(Section II or III of the Hardware guide). 


2. Ona PS/2 Model 50, 60, or 80, run the IBM 
configuration program on the Reference 
Diskette. 


3. Connect the cable (See the Hardware Guide). 


4. Make a backup copy of the IDEAcomm 
software and file the originals for safekeeping. 


6. Insert the diskette labeled IDEACOMM-1 
containing INSTALL.EXE. (At this point, you 
may copy all the IDEA diskettes to the hard 
disk, but INSTALL will do it for you more 
selectively.) Be sure that you are connected to 
the drive and path from which you want to run 
INSTALL. 


7. At the DOS prompt type: INSTALL <Enter> 


8. The first screen of the INSTALL program is 
displayed. Read and follow the instructions for 
this and subsequent screens. 


Error Messages 


When you run the INSTALL program, the 
Diagnostics Failed screen may be displayed with 
one of the following messages: 


Cannot copy file 
The IDEAcomm file that INSTALL seeks does not 
exist on Drive A. 


Cannot copy files to this directory 
The pathname may not exist or the drive may not 
be accessible. 


Could not determine memory and/or I/O 
addresses for the IDEAcomm 5251 Microchannel 


2-4 Basic Configuration 


Possible Actions: 

1. Run diagnostics with the TWINDIAG 
program. 

2. Reconfigure the Personal System/2 with the 
Reference Disk. 

The configuration could not be determined from 
values read from the card. The ADF file may be 
corrupted (see the hardware manual), or the 
problem may be card related. Call IDEA Technical 
Support. 


Emulation Card is Defective 
Call your local dealer. 


Emulation Card is Not Installed 
Check to be sure that you have installed the 
IDEAcomm card and that it is properly seated. 


Emulation Card not installed in Personal 
System/2 

The IDEAcomm micro channel card is either not 
installed or could not be found. 


IDEAcomm 5251/MC card failed diagnostics 
Possible Action: 

Run diagnostics with the TWINDIAG program. 
See Appendix A for use of TWINDIAG. 


Incorrect diskette in current drive 
Insert the diskette that is requested at the bottom 
of the screen. 


1/O Address DIP Switches are Not Set Correctly 
Check the switch settings on your IDEAcomm card 
(See the hardware guide). 


No space left in destination disk (diskette) 


Remove some files from the disk, or insert a new 
diskette. Restart INSTALL. 
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Running IDEACFIG 


If you have already run the INSTALL program, 
you do not need to run the IDEACFIG program 
unless you need to configure a user-defined printer 
not listed in the INSTALL program. Some users 
may want to further customize IDEAcomm by 
running the IDEACFIG program for features 
described in Sections IV through VII. 


If you have not run the INSTALL program, 
consider using it. INSTALL is the only program 
most users need to run, and it is quick and easy to 
use. Refer to the INSTALL card or this manual 
for instructions on using the program. 


Files Necessary to Run IDEACFIG 
IDEACFIG.EXE Configuration program 


TWINAXn.UCM Configuration data file; 
n is either 7 (default) or 4 
if you have the older 
IDEAcomm 5251 product. 


PRINTER.CMD Printer data file (whether 
you will configure a printer 
or not) 


xxx. VID If you use a third-party 
adapter 


xxx. KEY Applicable to your national 
language and keyboard 
layout 


A Note for Users Installing Upgrades 


If you are configuring TWINAX for the 
older IDEAcomm 5251 product, (4 LUs 
only), be sure that the file TWINAX4.UCM 
is in the same directory as IDEACFIG. 


2-6 Basic Configuration 


The Minimum That You Must 
Configure with IDEACFIG 


The following information is required for each 
display or printer you want to emulate: 


@ Model number: For the model of display or 
printer, TWINAX offers the following options: 


$251 model 11 §224 model 1 
5291 §225 model 1 
5292 model 1 5256 model 1 


5292 model 2 (graphics display)| 5219 — word processing 
3196 4214 model 2 — landscape and 
3180 model 2 (wide screen) multibin options 


e Station address (supplied by your host 
administrator) 


e Alternate station address (not required but 
strongly recommended) 


@ Whether it will use an IBM file transfer 
package (only on the 4 LU IDEAcomm/5251) 


@ PC printer model if you are using one 


® Your PC printer type (serial or parallel) if you 
are using one 


@ PC printer port (LPT1, COM1, etc.) if you are 
using one 


@ Hardware I/O Address set on your PC card 


@ Hardware Memory Address set on your PC 
card 


@ Keyboard layout (IBM or PC style). See the 
templates accompanying this manual. 


e@ National language 
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Invoking IDEACFIG 


Insert the diskette containing IDEACFIG.EXE (or 
copy the IDEAcomm software to your hard disk). 
Type the following at the DOS prompt: 


>IDEACFIG <Enter> 


You see the Main Configuration Screen: 


IDEACFIG Version x.x Copyright (C) 198x IDEAssociates Inc. 


Host Device Assigned Station IBM Key PC PC 
Session Type To Address Xfer Buf Printer Port 


No Device 
No Device 
No Device 
No Device 


IDEACFIG Main Options 


Host Session Setup 
Display Options 

User Interface Options 
Printer Options 
Keyboard Options 
Save & Exit 


Choice : 


Figure 2—1: Main Configuration Screen for IDEACFIG 


Changing Configuration 


If you change configuration while emulation is 
running, the changes do not take effect until you 
sign off the host, exit from emulation, and restart 
emulation. (See Section III.) 
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Host Session Setup 


From the main configuration screen, type 1 and 
press Enter to begin host session configuration. 


The system prompts: Which session number do 
you want to change? Type the number of the 
host session you wish to configure (1-4 or 1-7). 
After that, you see an arrow next to the current 
session number in the top half of the screen. The 
program prompts you through the following options. 


Type of Device 


The bottom half of the screen changes. It allows 
you to select the model number of the device you 
wish to emulate. Locate the number (1-10) that 
corresponds to the model number you wish to use: 


1) 5251-11 7) 5256 Prn 
2) 5291 8) §224/5225 Prn 
3) 5292-1 9) 5219 Prn 
4) 5292-2 10)4214 Prn 


5) 3180 
6) 3196 0) No Device 


Choice : 


Figure 2-2: Device Model Screen 


Notes 
You can configure three printer sessions. 


With IDEAcomm 5251 (the 4 LU version), 
for each 3180 display configured, 2 LUs or 
host sessions are used. 


With IDEAcomm 5251/Plus, you may 
configure any combination of display 
sessions, including several 3180 sessions, 
but on most systems, memory does not 
allow for more than five 3180 sessions. If 
you start to run out of memory, you see the 
message: 
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Insufficient memory to configure device. 


There is no more memory for LUs. If you 
need to continue, delete one of the LUs 
you have already configured, or change a 
3180 configuration to a different one. 


Type your choice (0-9) at the prompt. Choosing 0 
(No Device) removes an existing configuration. 


Station Address 


After you enter the device, the following prompt 
appears: 


Change station address 


Enter one decimal digit : 


[Press Esc to cancel] (only when reconfiguring) 
[Min 0 , Max 6] 


Figure 2-3: Station Address Screen 


Your host system supervisor or someone who has 
access to system configuration should tell you what 
model number and station address you can access. 


If the station address is incorrect, the emulation will 
not work correctly. The host uses the station 
address to send data to specific devices on a given 
piece of TWINAX cable. Each display or printer 
session must have its own address, so that the host 
can identify the device. 


A station address is required for every device you 
plan to emulate. Station addresses are always in 
the range of 0 to 6. 


Type the corresponding number (0-6) at the 
cursor. If you enter a station address that has 
already been chosen, a warning message is 
displayed on the screen. 
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Alternate Station Address 


The system displays the Alternate Station Address 
screen. If N is entered, no alternate station 
address is configured. If Y is entered, the following 
prompt is displayed: 


Alternate Station Address 
Enter one decimal digit: 


[Press Esc to cancel] (only when reconfiguring) 
[Min 0 Max 6] 


Figure 2—4: Alternate Station Address Screen 


The configuration program allows you to specify a 
primary and an alternate address. The primary 
address is used unless that address is currently in 
use. If the primary address is not available, the 
alternate station address is checked. 


Note 


When you select an alternate station 
address, be sure that it is assigned by the 
host to a compatible device type. If, for 
example, the addresses are for incompatible 
displays or if the primary address is for a 
display and the alternate is for a printer, 
then the emulation software will not operate 
correctly. 
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IBM Transfer Package (4 LU 
Upgrades Only) 


If you are upgrading a 4 LU version of TWINAX, 
when you indicate a display session, the screen 
displays the IBM transfer package prompt. Only 
one host session can be configured for this 
capability on 4 LU versions. 


Note 


This file transfer compatibility works with 
the System 3X only. For the AS/400, 
IDEA supplies a file transfer driver with the 
hardware package. 


Your choice on this screen determines whether the 
host session you are currently configuring will be 
able to use an IBM transfer package such as IBM 
PC Support/36 and IBM PC Support/38. 


Are you using an IBM transfer package? 
Enter Yes or No ( Y/N)? Y 


Note: Only 1 LU can be selected. 


Figure 2-5: File Transfer Capability Screen 
(4 LU Version Only) 


Note that the word “YES” appears on the screen 
next tothe station address field if IBM transfer 
package capability is chosen. Also, if you have 
configured host session #1 for this capability and 
wish to change the IBM transfer capability to, for 
example, host session #4, simply enter Y when 
configuring host session #4 and notice that the word 
YES moves from host session #1 to host session #4. 


Removing IBM Transfer Capability 


On a 4 LU version of IDEAcomm 5251, you can 
remove the IBM capability option from a host 
session by reconfiguring that host session. Simply 
enter NO in answer to the IBM file transfer 
prompt. 
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Keystroke Buffering (Display Sessions 
Only) 


IDEA allows you to buffer or save 64 characters 
per session. When the host is temporarily not 
accepting input, you can keep typing into the 
buffer. Once the host starts to accept input, it 
takes the input from the buffer. 


A program prompt asks: 


Do you wish to enable keystroke buffering? 


Enter Yes or No ( Y/N ) ? Y 


Figure 2-6: Keystroke Buffering Screen 


Answer Yes if you want keystroke buffering. 
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Select Attached Printer Model 


If you selected a printer session (4214, 5224, 5225, 
5256, or 5219), after the station address, you are 
prompted to name your PC printer: 


Attached Printer Model Type 


INEC 3550 Spinwriter parallel 
'IBM 5216 Wheelprint parallel 
‘HP LaserJet serial (9600) 
Okidata Microline 84 parallel 
IBM Color Printer parallel 
1IBM Quietwriter parallel 
IBM Proprinter parallel 
2Epson FX-286e “IBM Emulation” parallel 
2Epson LQ-1000 parallel 


1User Defined Printer 


Select the attached printer by moving the 
highlighted block cursor over the printer name 
and press <Enter>. Use up and down arrows. 


1 Suitable for 5219 printer emulation. 
2 Suitable for 4214, 5224, and 5225 emulation. 


Figure 2-7: Select PC Printer Model Screen 


This screen lists those printers that are already 
configured by IDEA. If your PC printer is among 
the choices, select it from the menu. You do not 

- need to configure any parameters for the printer. 

If your printer is not among the choices offered, 
choose User Defined and continue setting up your 
host session. If you choose User Defined, you 
must enter the appropriate escape sequences further 
on in IDEACFIG. (See Section VII.) 


You are then asked: 
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Select LPT printer or COM port device 

Enter one decimal digit : 

[Press Esc to cance!] (Only when reconfiguring) 
[1=LPT1, 2=LPT2, 3=LPT3, 4=COM1, 5=COM2] 


If you do not know how your printer is connected, 
ask your system administrator or refer to your DOS 
manual. 


Automatic Rearrangement of 
Configuration Selections 
If you are not configuring all 4 or all 7 host 


sessions, the system automatically renumbers host 
sessions consecutively starting from 1. 


IDEACFIG Version x.x Copyright (C) 198x IDEAssociates Inc. 


Host Device Assigned Station IBM Key PC PC 
Session Type To Address Xfer Buf Printer Port 


1 5251 -11 DISPLAY (0 ) No Yes 

2 5291 DISPLAY (2 ) No Yes 

3 5224 Prn PRINTER (4 ) IBM Proprinter LPT1 
4 No Device 


IDEACFIG Main Options 


Host Session Setup 
Display Options 

User Interface Options 
Printer Options 
Keyboard Options 
Write & Exit 


Choice : 


Figure 2-8: Sample Completed Host Session Setup for 
IDEACFIG 


Display Options 


These configuration options are discussed in 
Section IV. 
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User Interface Options 


When you select this option from the Main 
configuration screen, you see the following: 


1) Hardware I/O Address 

2) Hardware Memory Address . see discussion 
3) Power on Reset 

4) Virtual Floppy Drive 


5) Virtual Floppy Host Session . 1 
6) Virtual Floppy Time Out ... 30 
| Esc) Exit to MAIN 


Choice: 


Figure 2-9: User Interface Options Screen 


Hardware I/O Address 


This address must correspond to the setting of your 
IDEA card. If you have a PC or PS/2 Model 30 
and the screen does not correspond to the switch 
settings on the card, select 1) and enter the I/O 
address set on your card. See Appendix C of the 
hardware manual for switch settings. 


If you have a PS/2 Model 50, 60, or 80, you 
cannot change the address here. You must rerun 
the configuration program on the IBM Reference 
Diskette. See the hardware manual. 


Hardware Memory Address 


This address must correspond to the setting of your 
IDEA card. On Rev. D and higher, the address is 
set automatically. On the other cards, the memory 
address depends on switch settings. See Appendix 
C of the hardware manual for address information. 


If you have a PS/2 Model 50, 60, or 80, you 
cannot change the address here. You must rerun 
the configuration program on the IBM Reference 
Diskette. See the hardware manual. 
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Power On Reset 


If you specify YES to this feature, each time you 
warm boot with Ctrl—-Alt-—Del, the IDEAcomm 
emulation card is reset and the microcode file is 
reloaded (sessions are restarted). While emulation 
is being loaded, the IDEAcomm card stops 
responding to the host. This causes the host to 
respond as if the display were turned off. If you 
are in an application, often the display is frozen 
until the system operator releases it. 


If you specify NO to Power on Reset on Load, 
exiting TWINAX does not cause you to lose your 
sessions. The program only resets the card if 
power is turned off to the microcomputer, if 
emulation is not running, or if the configuration file 
has been changed. When you re-enter the 
TWINAX command, you return to the same place 
in emulation where you were prior to exiting or 
warm booting. The NO option on Power on Reset 
on load is helpful if you have to Teboot while in an 
application on the host. 


IDEA recommends that once your configuration is 
set, you enter NO on the Power on Reset on Load 
option. 


To change the Power on Reset on Load option, 
from IDEACFIG type 3 on the User Interface 
Options menu. To select YES or NO, use the 
space bar to display your choice and press Return. 


This option may be overridden from the emulation 
program if you specify Exit and Unload 
Microcode when you leave emulation. See 
Section III. 


Virtual Floppy Options 


You need these options if you are using an IBM 
file transfer package that uses a virtual drive on the 
microcomputer. See Section VII for more 
information. 
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Printer Options 


These options are discussed in Section VI. 


Keyboard Options 


When you select this feature from the main 
configuration menu, you see the following screen: 


Keyboard Options 


1) Select Keyboard Layout ... PC Keyboard, US 


2) Keyclick 
Esc) Exit to MAIN 


Choice: 


Figure 2-10: Keyboard Options Menu 


Keyboard Layout 


From the IDEACFIG Keyboard Options menu type 
1 to choose this option. It allows you to indicate 
the type of keyboard you have, the emulated 
layout, and the national language. For example, 
the first choices offered are: 


PC, U.S. IBM Layout 

AT, U.S. IBM Layout 
Enhanced, U.S. IBM Layout 
Generic 3180, U.S. IBM Layout 
PC, U.S. PC Layout 

AT, U.S. PC Layout 

Enhanced, U.S. PC Layout 
Generic 3180, U.S PC Layout 


See Table B—1 of Appendix B or your template for 
these layouts. IBM Layout is the 5250/3180 layout 
on the template. 
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The subsequent keyboard choices offer different 
languages. IDEA supports a number of national 
keyboards, which may vary with your system. 


Keyclick 


If you specify YES to this option, each time you 
press a key on the microcomputer an audible click 
occurs. If you specify NO, there is no sound. 


Saving the Configuration 


To save your configuration changes in the file 
TWINAXn.UCM, return to the main menu with 
Esc and then press Esc to exit the program. The 
program queries: 


Exit to DOS (Y/N)? 
Save the new information (Y/N)? 
Figure 2-11: Save/Exit Menu 


Answer Y to both questions. 
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Section ITI: 
Using Emulation 


Activating Emulation 
Software 


To start emulation, complete the following steps: 
1. Install the hardware (hardware manual). 


2. Run either the INSTALL or IDEACFIG 
program (Section II) to check at least the 
following: 


@ type and model number for each host 
session 


@ station address for each host session 


@ alternate station address (not required but 
recommended) 


e IBM file transfer capability if needed 
@ memory and I/O address of the card 

@® correct keyboard layout and nationality 
@® printer characteristics 


3. Check that you have the necessary files to run 
TWINAX (see the next page). 


4. Load emulation with the command TWINAX. 


If desirable instead, make emulation resident by 
typing TWINAX R. You are returned to the 
DOS prompt, from which you may move back 
and forth to emulation by pressing Shift—Shift. 
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Files Necessary to Run IDEAcomm 
(TWINAX) 


In order to load the TWINAX program, you must 
have the following files in the directory from which 
you invoke TWINAX: 


TWINAX.EXE 
TWINAX7.UCM 
TWINAX7.MI 


If you are upgrading the 4 LU version (IDEAcomm 
5251), you must have TWINAX4.UCM and 
TWINAX4.MI instead of the last two files above. 
These files are included with the IDEA software. 


In addition, you may need the following files for 
special applications: 


GR5292.EXE for graphics processing 

SEND.EXE for the SEND function 

SNDEDIT.EXE for creating SEND record 
files 


AUTOTWIN.EXE for the AUTOTWIN 
function 


ADDVDSK virtual disk driver for some 
IBM file transfers 


REMVDSK removes virtual disk 
software from memory 
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Loading the TWINAX Software 


To load the emulation software, type the following 
at the DOS prompt: 


TWINAX <Enter> 


The IDEAcomm software performs a station 
identification test to verify that the configured 
station address is not currently being used by 
another user on the TWINAX run. If the station 
address is already in use, the software checks the 
alternate station address (if configured) to 
determine whether it is available for use. 


After this check is completed, the screen listing 
changes and displays the granted station addresses. 
If the configured primary address is not being used, 
the address is granted. If the primary address is 
being used by another device on the TWINAX run, 
then the alternate station address is granted if that 
address is not being used. If both the primary and 
alternate addresses are already in use, the host 
session becomes inactive and the Address column 
shows “ACCESS DENIED.” 


IDEAcomm 5251® 
Version x.x.xX 
Copyright (C) 198x IDEAssociates, Inc. 


System Configuration 


Session Type Address Status 
LU # 1 $251-11 3 GRANTED 
LU #2 3180 4 GRANTED 


Figure 3-1: Initial TWINAX Screen with 
Granted Station Addresses 
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Options on the TWINAX Command 
Line 


You can load the TWINAX emulation program 
automatically by using the R option with TWINAX: 


TWINAX R_ <Enter> 


TWINAX is invoked and the system automatically 
returns to DOS to execute other commands, leaving 
TWINAX resident. 


You can also invoke TWINAX and then terminate 
it with the command: 


TWINAX EXIT (abbreviation: TWINAX E) 


This option causes emulation to terminate but does 
not unload the microcode. See EXIT under the 
Command Menu further on in this section for a 
discussion of exiting. 
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Making TWINAX Resident or 
Non-Resident in Memory 


To make TWINAX resident, hot key back to DOS 
with Shift—Shift (pressing both Shift keys together). 
Once the Hot Key is used, TWINAX is resident. 


Once TWINAX is resident, you can Hot Key 
between DOS and TWINAX emulation by pressing 
the two Shift keys together. More information on 
the Hot Key is given further on in this section. 


Making TWINAX non-resident removes the 
emulation software program from your 
microcomputer’s memory, freeing up DOS memory. 
To make emulation non-resident, you must exit 
TWINAX: 


1. Use Ctrl—Esc to see the Command Menu. 


2. Use the arrow keys to move the lighted bar to 
Exit and press Enter. 


3. At the prompt, choose unload microcode if 
you want to change configurations; otherwise 
choose do not unload microcode. 


4. At the next prompt answer YES to the query, 
uninstall? 


Using Emulation 3-5 


Operating in Emulation 
Using LUs 


The TWINAX software supports emulation of seven 
system devices, including three printers. Thus 
several tasks, such as order entry, file transfer, and 
printing, can be done at one time. Each emulated 
display or printer is called a Host Session or 
Logical Unit (LU). For example, a few possible 
configurations are: 


@ seven IBM displays 
@ two IBM 3180 displays and three other displays 


@ one 3180 display, three other displays, and two 
printers 


e@ five 3180 sessions and one printer 


The following commands are helpful in viewing and 
using LUs: 


Ctrl-L: Cycle through LUs (if more than one 
window is displayed, Ctrl1—-L cycles only 
through displayed LUs). 


Alt-Esc: Cycle through LUs and through DOS. 


Ctrl-—W: View more than one LU at once in 
windows. Windows are discussed below 
and in Section IV. 


Using the Emulated Keyboard 


The IBM PC and PS/2 do not have all the keys on 
a system keyboard. For example, there is no Reset 
key. Therefore, IDEA has provided keystroke 
combinations to emulate the system keys. Use the 
templates that accompany this manual, or the 
charts in Appendix B, to find the keystroke 
combinations for emulated keys. 
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Exiting Emulation 


To exit emulation, if you have made emulation 
resident, you may go back and forth to DOS with 
the Hot Key while emulation remains resident. 


Ending Emulation 


If you want to clear emulation from memory, 
thereby terminating it, press Ctrl—Esc for the 
Command Menu. Then choose Exit and press 
Enter. From the next menu, choose Exit again. 
In answer to the query, uninstall? answer Y. 
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The Sign-on Screen and 
Status Line 


Once TWINAX has checked access, you see the 
screen for the first LU available. For a printer, 
you see the Printer Control Panel described in 
Section V. For a display LU, you see the host 
sign-on screen, which varies with your host and 
your application. 


The bottom line of the screen is the IDEA status 
line: 


n# 


Session ID 


Status Line 


Figure 3-2: Status Line 


Status Line Indicators 


An IBM midrange display station has five status 
indicators along the bottom or right edge of the 
screen. In addition to the five IBM status 
indicators, IDEA adds GM for graphics (in 
emulation of 5292 model 2) and two status 
messages located in the lower right side of the 
screen. These messages indicate the Host Session 
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and Station Address of the screen that is currently 
being displayed. 


Each of the indicators can be either active or 
inactive, and all indicators are displayed constantly. 
The status line items are active if the colors are 
reversed. 


If you are using windows, note that if the window is 
not at least 25 characters wide, not all of the status 
indicators will be displayed. 


The various indicators are described in Table 3-1. 


Table 3-1: Status Indicators 


IBM Indicator Abbreviation Explanation of the Status 


Row/column xxx/yyy}! Location of the cursor. 


The 5250 controller and the TWINAX 
program are operating and ready. 


The session is a 5292-2 display. If the 
indicator is active (reverse video), 
graphics are being processed or waiting. 


System Available 


Graphics Mode 


Message Waiting Your terminal has messages to be 


displayed. 


Keyboard Shift 


Insert Mode 


Your keyboard is in shifted mode. 


Your keyboard is in insert mode. 


Input Inhibited Your keyboard is locked because your 
terminal is waiting for the controller to 
respond, the system is processing the 

previous function key, or there is some 


error condition. 


The n indicates the Host Session 
number that is currently displayed. If 
windows are active, then Sn is displayed 
in reverse video in the currently active 
window. 


The n indicates the TWINAX Station 
Address of the displayed Host Session. 


Host Session 


Station Address 
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Using the Hot Key 
(Shift-Shift) 

Once the TWINAX program is resident in memory 
you can move back and forth between TWINAX 
emulation and DOS, or a DOS application program. 
For example, while you are running TWINAX and 


are connected to the host, you may need to edit a 
file with a text editor. 


You can hot key out of TWINAX at any time, 
‘whether the system is idle or whether any program 
or command is executing. You return to whatever 
DOS command or program was executing when you 
hot keyed into TWINAX, and continue from where 
that command or program left off. If the system 
was idle, you return to the DOS prompt. 


When you return to emulation, you see the host 
session displayed when you hot keyed to DOS. Ifa 
program was running when you left emulation, the 
program continued to run even though the host 
session was not displayed. Therefore, the host 
session screen display may be different than the 
one displayed when you hot keyed to DOS. 


Windows: Viewing More 
than One Session at Once 


The window feature lets you see more than one LU 
at once. For example, you can monitor printer 
status in one session while typing data in another 
and, at the same time, checking when compilation 
finishes in a third session. 


To create windows, see the Border option of 
WINDOWS in the Command Menu described 
below. 


You cannot go into multiple windows (Ctrl-W) 

from a session not selected in the WINDOWS 

option of the Command Menu discussed in this 
section. 
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The Command Menu 


From emulation, enter Ctrl—Esc to see the following 
menu: 


EXTENDED 


WINDOWS 


FREE 


PRINT 


RESERVE 


SAVE 


VIEW SETUP 


VIRTUAL 


TWINAX Version x.x 
Microcode Version x.x 
Keyboard type 


Display or hide attributes on the screen. 
Select window layout from a menu. 
Free sessions. 


Change output of PrintScreen 
to a disk file or printer. 


Reserve sessions without rerunning the 
configuration program. 


Save configurations, windows, or record keys. 


View configuration without rerunning the 
configuration program. 


Change session number, drive, and timeout 
parameter for a virtual disk. 


Exit with microcode loaded, exit and unload, 
or do not exit but leave Command Menu. 


Figure 3-3: The Command Menu 


To select one of these options, either: 


1. Use the cursor arrows to move the lighted bar 
to your choice, then press Enter. 


2. Type the first letter of the option you want. 
For Extended, Exit, View Setup, and Virtual, 
you may have to type the letter twice. 


The Hot Key is not processed while you are in the 
Command Menu. 


To exit the Command Menu, press Esc. 
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Getting Help 


Help is available for each command on the menu. 
Move the lighted bar to the command you want 
and press F1. 


EXTENDED 


This option allows you to choose whether or not to 
display field attributes (protected, intense, etc.) on 
your screen. For troubleshooting or other 
purposes, you may wish to inspect field attributes. 
The default is not to display them. 


WINDOWS 


This option has three sub—options: 


Border lets you choose the layout of your windows: 
in which quadrant of the screen to display each 
session and how many sessions to display at once. 
When you choose this option, press Fl to see a 
series of possible diagrams of layout. Choose one 
and press Enter. 


2 4 
Figure 3—4: Sample Border Layouts 


Sessions Displayed lets you choose as many as 
four of the configured sessions for display. When 
you select this option, you see a list of sessions 
configured. Enter the session numbers you wish 
displayed in windows. 


Reset Configuration resets the window layout to its 


original setting when you last started TWINAX, or 
to the state last saved within TWINAX. 
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FREE 


This option lets you free a session so that another 
user may sign on with that station address. When 
you choose this option you see a sub-menu that 
lists each reserved session plus the option “All 
reserved sessions.” Move the cursor to your choice 
and press Enter. 


PRINT 


This option lets you change the output assignment 
for printing screens with the PrintScreen key. You 
are prompted for the filename, which may be a 
disk filename or a printer such as LPT1. The 
default is LPT1. 


This option does NOT print anything. (The 
PrintScreen key is Shift—PrtSc, or Shift-PgUp for 
the Enhanced Keyboard.) 


RESERVE 


This option lets you reserve a session that you have 
configured but freed, or to which access was denied 
when you started emulation. For example, if 
another user has finished with a session address, 
you can now start a session with the same address. 
When you select this option, you see a listing of all 
free sessions, plus the option “Reserve all primary 
sessions.” Move the cursor to your choice and 
press Enter. 
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SAVE 


Save Configuration: If you change the freed and 
reserved status of addresses and alternate addresses, 
you can save the new configuration of station 
addresses with this option. For example, you might 
want to switch a primary and an alternate station 
address. 


This option also saves information on the virtual 
disk discussed on the next page. 


Save Record Keys: The record feature is 
explained further on in this section. If you have 
used Alt-R from one or more sessions to record 
keystrokes, you can save them permanently. SAVE 
RECORD KEY saves the recorded sequences in all 
sessions. This means that you can use the same 
keystroke sequences the next time you load the 
TWINAX software and enter the host session 
associated with this record buffer. 


Save Windows: The current window configuration 
may be saved with this option, for use in the 
future. 


VIEW SETUP 


This option gives you a summary of the options 
configured with INSTALL or IDEACFIG, similar to 
the following: 


The Current Configuration: 


LU 41 5251-11 Address 0 
LU #2 5292-2 Address 2 
LU #3 §219 Address 6 


Memory: D000 I/O Port: 368 


Figure 3-5: Sample Setup 
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VIRTUAL 


If you want to create or change a virtual disk, 
choose this option. You are prompted for session 
number, drive, and timeout interval. Virtual disks 
are used with some IBM file transfer packages. 
See Section VII for more information on virtual 
disks. 


EXIT 


You have three options: 


Exit With Microcode Loaded means that no signal 
is sent to the host, which continues processing your 
job as though you were still logged on. When you 
use the command TWINAX again, you will have 
the same sessions running as now. (This is true as 
long as you do not reconfigure with INSTALL or 
IDEACFIG, do not turn power off to your 
microcomputer, and have Power On Reset in 
IDEACFIG set to No.) You get the further 
prompt: Do you wish to uninstall? if TWINAX 
is resident. If you answer No, you are returned to 
emulation. 


Exit And Unload Microcode means that when you 
use the command TWINAX again, the sessions will 
be restarted. You get the further prompt: Do you 
wish to uninstall? if TWINAX is resident. If you 
answer No, you are returned to emulation. 


Do Not Exit gets you out of the Command Menu 
but you remain in emulation. 


If you want to return to DOS without stopping 
emulation, use the Hot Key (Shift-Shift). 
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Record/Playback 


This feature allows you to store keystrokes in a 
buffer and play back the keystrokes later. A total 
of 906 bytes is available for recording from all LUs 
together. You can selectively delete a series of 
stored keystrokes or delete the entire contents of 
the record buffer for the host session you are 
currently using. 


Keys Used 


The following key combinations are used with the 
Record/Playback option: 


Alt-R begins or ends recording. 

Alt—P plays back the previously recorded 
keystrokes. 

Alt-—C cancels a specific recorded sequence of 
keystrokes. 

Alt-E erases the contents of the record buffer 


thereby erasing all recorded sequences 
of keystrokes for the current host 
session. 


Record 


To begin a record sequence, from within TWINAX 
emulation press Alt-R. The letters RC appear on 
the host session status line, indicating that record 
mode is active. 


Press any key. The keystrokes you enter are saved 
to the key you pressed. If you choose a key that 
has already been used to store Keystrokes, the new 
Keystrokes overwrite the old ones and you lose the 
original keystrokes. 


A number is displayed next to the RC in the status 
line. This number indicates the number of 
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characters still available in the record buffer. Each 
time you type a Keystroke, this number decreases 
by one and your Keystroke is transmitted to the 
host. 


When you have finished recording, press Alt-R to 
stop recording. 


Playback 


To play back a previously recorded sequence of 
Keystrokes, press Alt-P. The letters PB are 
displayed on the host session status line. 


Enter the key that is associated with the sequence 
of recorded keystrokes you wish to play back. 


Cancel 


To cancel (delete) stored keystrokes in a specific 
record sequence, enter Alt-C. The letters CR 
appear on the left of the host session status line. 


Enter the key that is associated with the sequence 
of recorded keystrokes you wish to delete. 


Erase 


To erase all recorded keystrokes in the record 
buffer of the host session currently in use, press 
Alt-E. 


Saving the Record Buffer 


Use the Command Menu’s SAVE option to save all 
recorded keystrokes in all sessions for future use. 
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Batch Files 


A batch file consists of commands grouped together 
in a file. When the file is executed, each of the 
commands within it is automatically executed. 


For example, use an ASCII editor to create a file 
and name it MINE.BAT. Type the following in the 
batch file: 


TWINAX R_ <Enter> 
Close the file and, at the DOS prompt, enter: 
MINE <Enter> 


TWINAX is invoked and the system automatically 
returns to DOS to execute other commands, leaving 
TWINAX resident. 


You can also invoke TWINAX and then terminate 
it with the command: 


TWINAX EXIT (abbreviation: TWINAX E) 
See page 3-4 for a discussion of the EXIT option. 


The AUTOTWIN command discussed on the next 
page is also helpful for batch files. 


SEND Utility 


You can create a batch file that sends keystrokes to 
the host automatically, similar to the Playback 
function but with the added ability to detect input 
from the host and respond. This is a SEND file. 


See Appendix D for how to create a SEND file, 
which ends with the extension .SND. 


Once TWINAX is loaded, hot key to DOS and 
enter: 


SEND [filename] <Enter> 
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where filename ends with the extension .SND. 
(You do not need to enter the extension.) 


If you enter SEND with no filename, the utility 
looks for the default file TWINAX.SND. 


The SEND utility may send all the keystrokes (for 
example, a login sequence) to the host and, when 
finished, return to DOS. Use the Hot Key to 
return to the last screen. 


When the SEND utility returns to DOS, it displays 
the message SEND completed -- Use Hot Key to 
resume emulation. 


In batch files, suppress the screen display as 
discussed in Appendix D, and end with the 
command AUTOTWIN. 


AUTOTWIN Command 


The AUTOTWIN command is especially useful in 
batch files, where the Shift-Shift combination 
cannot be entered. When you type AUTOTWIN at 
the end of a batch file, the system automatically 
executes the Hot Key. TWINAX must already be 
resident. If TWINAX is not resident, a batch error 
code of 1 is returned in the batch file. 


For example, when you are ready to work in 
emulation, you could execute a batch file 
containing the following: 


CD \MEMOS 

DELETE OLDEST 
RENAME LATEST OLDER 
C:\ TWINAX 

AUTOTWIN 


You can also hot key automatically into TWINAX 
emulation by typing AUTOTWIN at the DOS 
prompt instead of entering Shift-Shift. If TWINAX 
is not resident, AUTOTWIN aborts and displays an 
error message. | 
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Emulation 


Exit (from Command 
Menu) 


Program can be resident or non-resident. 


At {dy Alt-Esc 


Cycles among sessions and DOS. 


Ctrl-—L 


Cycles among sessions. 


Ctrl—Esc 


Cycles between emulation 
and the Command Menu 


Hot Key (Shift-Shift) 


Returns to DOS: Program is still resident. 


Ctrl—W 


Displays more than one host session at once. 


Figure 3-6: Summary of Emulation Keys 
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Section IV: 

Displays, Windows, 

and Graphics 
ae 


Windows: General 
Information 


This feature allows you to view from 1 to 4 
windows on the PC or PS/2 monitor at one time. 
Each window represents a host session. Control 
key sequences allow you to move between windows 
in order to access a host session. All windows are 
concurrently updated by the host regardless of the 
host session with which you are working. 


Setting Up Windows from Emulation 


From emulation, press Ctrl—Esc to see the 
Command Menu. Move the cursor to WINDOWS 
and press Enter. From the second option, 

Sessions Displayed, be sure that the sessions or 
LUs that you want to view are selected. Then from 
the first option, Border Type, press F1 for a help 
screen on layouts available: 


You may select a maximum of four windows to 


view at once. 


Select the layout you want and press Enter or Esc. 
To save this layout for future use, from the main 
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Command Menu select SAVE and then 
WINDOWS. 


Exit from the Command Menu with Esc. Then be 
sure that you are in one of the host sessions that is 
among the Sessions Displayed on the menu, and 
press Ctrl-W. You will see windows with all of the 
sessions you chose. To return to one full window, 
use Ctrl—W again. 


You cannot go into windows from a session not 
selected in the WINDOWS option of the Command 
Menu. 


Activating the Window Option from 
IDEACFIG 


From IDEACFIG, windows are activated from 
option 3 on the Display Options menu. This option 
is effective if you have already configured windows 
from within the TWINAX program. 


Option 3 leads to the Additional Display Options 
menu: 


1) Window Mode on Load 
2) Video Adapter 
Esc) Exit to Previous Menu 


Choice : 


Figure 4-1: Additional Display Options 


Select option 1 and choose either NO or YES in 
response to the prompt. If you choose NO, then 
when you enter emulation mode, the window option 
will not be active but can be activated by typing 
CTRL-W. If you choose YES, then when you 
enter emulation mode, you will see all configured 
windows. 
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Altering Windows from the Emulation 
Program 


The commands in Table 4-1 can be executed from 
TWINAX emulation. 


Table 4-1: Window Commands 


Command 


Ctrl-L 


Ctrl—-right arrow 
Ctrl-left arrow 
Ctrl—-up arrow 
Ctrl-down arrow 
Ctrl-End 
Ctrl-Home 
Ctrl-PageUp 
Ctrl-PageDown 
Alt-right arrow 


Alt-left arrow 


Alt-up arrow 


Alt-down arrow 


Description 


Turns windows ON and OFF. When 
CTRL-W is toggled OFF, the current window 
is displayed full screen. 


Moves the cursor to the next window and 
makes that session active. 


Scrolls the text to the right one character. 
Scrolls the text to the left one character. 
Scrolls the text up one line. 

Scrolls the text down one line. 

Scrolls down one page. 

Scrolls up one page. 

Scrolls up one page. 

Scrolls down one page. 


Moves the current active window’s boundary 
to the right one position (changes window 
size). 


Moves the current active window’s boundary 
to the left one position. 


Moves the current active window’s top 
boundary up one line. 


Moves the current active window’s bottom 
boundary down one line. 
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Saving Window Configurations 


Save the current window configuration permanently 
by using the Command Menu (Ctrl—Esc). From 
the Command Menu, select SAVE and then 
WINDOWS. 


Tips on Using Windows 


For each host session configured as a display, the 
status line is displayed along the bottom of the 
session. (Refer to Line Indi rs in 
Section III.) 


In order to fit all status indicators on the status 
line, a window must be at least 25 characters wide. 
As you shrink the window width, part of the status 
line will be lost. 


The boundaries between sets of host sessions can 
be made irregular with Alt and the arrow keys: 


Ea =a a 7 
| 3 | 4 | 


Windows can be reduced in the horizontal direction 
to zero, causing the host session in that sector to be 
displayed no longer. » 


You may use the Sessions Displayed sub-—option to 
select any order for display of the windows. 


A 3180 wide screen display, when used in a 
window, is not condensed. 
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The 3180 Display: Viewing 
132 Columns 


IDEA provides full 132 column, 3180 emulation for 
video adapters that support 132 columns. 


This option is available only if you have configured 
a host session as a 3180 display and have a suitable 
adapter. If you do not, see the discussion on page 
4—7, 


If you choose 3180 emulation for your 
microcomputer, and you have a 132 column video 
adapter that you specify with IDEACFIG, you will 
normally see all 132 columns and 28 lines when the 
host session sends a large display. 


Configure for 132 column support as follows: 


1. At the DOS prompt, type IDEACFIG <Enter>. 
The Main Options Menu is displayed (Figure 
2-1). 


2. From the Main Options Menu, enter 2, Display 
Options. 


3. From the Display Options Menu, enter 3, 
Additional Display Options. 


4. From the Additional Display Options Menu, 
enter 2, Video Adapter. 


5. Use the space bar to highlight the type of 
adapter you are using for your particular display 
(monochrome, color, EGA, or third-party). 
The screen displays filenames ending in .VID 
that are located in the same directory. Press 
the Enter key to make your selection. 


Note that the screen is not condensed if you use 
more than one window. 
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IMPORTANT 


IBM’s video adapter (designated as 
Standard) does not support full viewing of 
132 column, 3180 emulation. If you wish 
to use this feature in Release 5.2, you must 
have one of the following video adapters: 


@ ATI Graphic Solution Color or Mono 
@ ATI EGA Wonder Color or Mono 
e Tseng Labs EVA color 


e STB Chauffeur HT CGA Color or 
Mono 


@e STB Multi Res II EGA Color or Mono 
@e Ahead Systems, Inc. VGA Enhancer 


Contact IDEA Technical Support for 
additional video adapters supported by 
IDEA. 


Condense Key (Ctrl-M) Used with 
3180 Emulation 


This key alternates between condensed (132 
column) and regular (80 column) display. For the 
key to be effective, you must have specified, with 
IDEACFIG, 3180 emulation and a video adapter 
with 132 column support. Then when you start 
emulation, if the host sends a large screen, you will 
see the entire screen condensed onto the PC or 
PS/2 screen. To view only part of the screen at 
full size, press the Ctrli-M key combination. To 
return to condensed viewing, press Ctr1—-M again. 


If you move from condensed to regular display with 
Ctrl-M, you can view all the columns and lines by 
scrolling and by using the cursor keys as described 
on the next page. 
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Viewing 3180 Emulation with an 80 
Column Video Adapter 


If you choose 3180 emulation for your 
microcomputer, but you do not have a 132 column 
video adapter, you can still do 3180 emulation. To 
view all the columns and lines, use: 


Ctrl-PageUp up one page 
Ctrl-PageDn down one page 
Ctrl-Home up one page 
Ctrl-End down one page 
Ctrl—up arrow up one line 
Ctrl—-down arrow down one line 
Ctrl—-right arrow right one column 
Ctrl—left arrow left one column 


The 3180 Shadow Cursor 


When you use a 3180 host session with an 
application that takes advantage of this feature, you 
will notice a second cursor at the top of the screen. 
This cursor moves across the top of the screen as 
you enter data. It lets you know in which column 
you are typing. 
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5292 Displays: Using 
Graphics Programs 


There are two models of 5292 display stations: 
@ model 1 — color display 
@ model 2 — color and graphics display 


5292 model 2 terminal emulation requires an 
enhanced graphics video adapter (EGA) with 256K 
of memory and an enhanced color monitor. 


Using GR5292 


The TWINAX graphics program, GR5292, allows 
you to use a host graphic program such as IBM’s 
popular Business Graphics Utility (BGU). 


GR5292 is loaded from DOS with the command: 
GR5292 <Enter> 


When you try to hot key from emulation to DOS 
after loading GR5292, the screen displays the 
following message and prompt: 


GR5292 Graphics Program is Running 
Select an option: 

(1) Return to emulation or 

(2) return to DOS and end the graphics 
program. 


Note that returning to DOS inhibits graphics in the 
host session until GR5292 is reloaded. 


GR5292 may display the following message: 


To display graphics, the GR5292 graphics 
program needs to be loaded from DOS. Hot key 
to the DOS session and then at the DOS prompt, 
type GR5292 and press the RETURN key. 
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Possible reasons for this message are: 


1. You attempted to display a graph from 
emulation without first loading GRS292. 


2. The display is not configured as a graphics 
display session. 


3. The correct adapter is not installed. 


The keyboard is disabled while the graph is being 
processed. However, once the graph is completed, 
you can print it on a local printer by using the 
PRINT SCREEN (PrtSc) key. 


For instructions on how to set up your local PC 
printer to print graphics, see Section VI. 
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Configuring Display Options 


with IDEACFIG 


When you choose this option from the main 
configuration screen, of IDEACFIG, you see the 


following choices. 


IDEACFIG Version x.x Copyright (C) 198x IDEAssociates Inc. 


Host Device Assigned Station 
Session Type To Address 


$251 m11 DISPLAY (0 
$291 DISPLAY (2 
5292 m1 DISPLAY (6 
5219 Prn PRINTER (4 


) 


) 
) 
) 


IBM Key PC PC Port 
Xfer Buf Printer 


No Yes 
No Yes 
Yes Yes 
User Defined Printer LPT1 


Display Options 


Remap Color Attributes 


EBCDIC / ASCII Display Translation 


Additional Display Options 


Set Column Separator Character .... 


§251 Display Type 

Cursor Type 

Color Attribute Mapping 
Esc Exit to MAIN 


Choice : 


Figure 4-2: Display Options 


Remap Color Attributes 


You can change the way fields are displayed with 
the attributes configuration screen. The attributes 
are used by programmers on the host to highlight 
different functions for different areas of a display 
screen such as input, or hidden, or error fields. 
You can create different display combinations for 
the existing codes. For example, color attribute 

39 normally displays as a red foreground on a black 
background. You may want to change it so that it 
always shows a black foreground on a blue 


background. 
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To remap color attributes, from IDEACFIG type 1 
on the Display Options screen. The next screen 
you see depends on your choice of color attribute 
mapping (Option 7 on the Display Options screen). 
See the following pages for the different Color and 
Monochrome screens. 


5292 Model 1 Emulation with IBM Color 
Display Adapter: Make sure that the Color 
Attribute Mapping option on the IDEACFIG 
Display Options menu is set to color. The following 
screen is displayed: 


IDEACFIG Version x.x Copyright (C) 198x IDEAssociates Inc. 


Code Foregrnd Backgrnd Blink Code Foregrnd Backgrnd Blink 
Green Black 21 Black Green 
White Black 23 Black White 
L-Green Black 25 Grey Green 
Br-White Black 27 Red Black 
Red Black 29 Black Red 
Red Black 2B Black Red 
L-Red Black 2D Grey Red 
L-Red Black 2F Red Black 
Cyan Black 31 Black Cyan 
Yellow Black 33 Grey Brown 
L-Cyan Black 35 Grey Cyan 
Yellow Black 37 Red Black 
Magenta Black 39 Black Magenta 
Blue Black 3B Black Blue 
L-Magenta Black 3D Grey Magenta 
L-Blue Black 3F Red Black 


Status Line -> 99 White Blue 
Enter Hex Code to Edit (ESC to quit) 00 


Figure 4—3: Color Attributes Screen 


Note that Figure 4-3 shows 32 different codes with 
display attributes assigned to each code. In 
addition there is one special code used to format 
the status line. 


Each value you see in the code column corresponds 
to an IBM 5292 type display attribute. These 
attributes are described in detail in Appendix B. 
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5251 (Monochrome) Emulation with IBM Color 
Display Adapter: Make sure that Color Attribute 
Mapping on the Display Options menu is set to 
Mono. The following screen is displayed: 


IDEACFIG Version x.x Copyright (C) 198x IDEAssociates Inc. 


Code Foregrnd 


White 
Br-White 
White 
Br-White 
White 
White 
White 
Br-White 
White 
Br-White 
White 
Br-White 
White 
Br-White 
White 
Br-White 


Backgrnd Blink Code 


Black 
Black 
Black 
Black 
Black 
Black 
Black 
Black 
Black 
Black 
Black 
Black 
Black 
Black 
Black 
Black 


No 
No 
No 
No 
Yes 
Yes 
Yes 
Yes 
No 
No 
No 
No 
Yes 
Yes 
Yes 
Yes 


Black 
Black 
Black 
White 
Black 
Black 
Black 
White 
Black 
Black 
Black 
White 
Black 
Black 
Black 
White 


White 
White 
White 
Black 
White 
White 
White 
Black 
White 
White 
White 
Black 
White 
White 
White 
Black 


Foregrnd Backgrnd Blink 


No 
No 
No 
No 
Yes 
Yes 
Yes 
Yes 
No 
No 
No 
No 
Yes 
Yes 
Yes 
No 


Status Line -> 99 White Blue No 
Enter Hex Code to Edit (ESC to quit) 00 


Figure 4-4: Monochrome Attributes Screen 


Changing the Attributes Assigned to an Existing 
Code (Color or Monochrome Option): 


1. To make a change, type the code number you 
wish to edit, and press Enter. 


2. The foreground column is highlighted. Use the 
cursor keys (up and down arrows) on the 
numeric keypad to cycle through the options 
until the desired value is displayed. 


3. Use the right cursor key to highlight the 
background column. 


4. Use the up and down cursor keys to cycle 
through the background options until the 
desired value is displayed. 
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Use the right cursor key to highlight the BLINK 
column. Use the up cursor Key to change the 
blink field to the desired state. 


To change any selections, use the left cursor 
key to move back to previous fields. 


Once you are satisfied with the selections, press 
the Esc key to save the changes temporarily. 


Repeat this process for each code you wish to 
change. 
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EBCDIC/ASCII Display and Printer 
Translation 


The EBCDIC/ASCII translation tables are 
configured by IDEA. You should not change them 
unless your system administrator notifies you that 
the host is sending unusual codes (for example, 
non-English codes) to the screen or printer. 


IDEAcomm uses two translation tables. One 
translates IBM EBCDIC codes displayed on the 
terminal screen into ASCII codes that the IBM PC 
or PS/2 displays. The other translates EBCDIC 
codes for the printer into ASCII codes the PC 
printer uses. There is a separate table for each 
printer session because different printers may have 
slightly different character sets. 


The IDEACFIG configuration program allows you 
to alter the translation tables in the configuration 
file. 


Note 


Before making any changes, make a backup 
copy of TWINAXn.UCM. If you should 
make an error, you will be able to restore 
the previous setup. 


Changing the Printer or Display Translation 
Table: ‘To alter the Display translation table, from 
IDEACFIG type 2 on the Display Options Menu. 


To alter the Printer translation table, from 
IDEACFIG’s Printer Options menu select the 
printer you want to emulate, and from the 
subsequent menu type 3. 


Along the top of the screen the first hex character 
(most significant 4 bits) of the EBCDIC code is 
shown. Along the left side the second hex 
character (least significant 4 bits) is shown. The 
value located in each cell is the ASCII value used 
to translate the EBCDIC value from the controller. 
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Select Option 1 (Edit Entry). You are prompted 
for the hexadecimal value of the EBCDIC code you 
want to change. Type this value and press Enter. 


The cell you are about to change is highlighted and 
the program prompts you for the new ASCII value 
(in hexadecimal). Type this value and press Enter. 


The new value is placed in the table and the 
original screen is displayed with the change. 


Continue this procedure until all the changes are 
entered. When you are satisfied with the changes, 
select option 2 (Exit saving changes), to 
permanently update the TWINAXn.UCM file. If 
you do not wish to save the changes, press Esc. If 
you save the file, the new table becomes active the 
next time you invoke the TWINAX program. 


For example, if you want code 7B from the 
controller, which normally is a curly brace, to be 
displayed or printed as é (e with an acute accent), 
change the value in CO from 7B to 82. 


ASCII charts are at the end of Appendix A. 
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Notes on the Printer Table: The default USA 
version printer table is shown in Figure 4—S. 


PRINTER 1ST HEX CHAR 


2 
N 
D 


Arma Kumar 
AMOUAWPOMIDMNEWNHO 


1) Edit Entry 2) Exit saving changes Esc) Exit without changes 
Choice: 


Figure 4—5: EBCDIC to ASCII Printer Translation Table 


Typically, IBM midrange computers work with 
printer codes greater than 40 Hex. Those below 
40 Hex are reserved for commands. However, 
there is one midrange command that allows the 
EBCDIC code to pass directly through to the 
printer, called transparent mode (TRN). It is 
discussed in Section I of the Technical Reference 
Guide. 


Values below 40 Hex are filled with FF Hex, which 
indicates that this character is not displayed. IDEA 
software substitutes an ASCII ’—’ (value 2D Hex). 
There is a mechanism for the host to change this 
value if you want another default character, or you 
can change the FF in the EBCDIC location to the 
ASCII code you prefer. If you write special print 
drivers on the IBM host to take advantage of the 
special features of your PC printer, you can change 
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DISPLAY 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 
A 
B 
C 
D 
E 
F 


these values to match control codes for your 
printer. Because the IDEAcomm communications 
system does not use the table to find commands in 
the host print data, you can change any value you 
wish. 


Notes on the Terminal Display Table: The 
default U.S.A. display table is shown in Figure 4-6. 


1ST HEX CHAR 


DB 27 
OF DB CD 20 


1) Edit Entry 2) Exit saving changes Esc) Exit without changes 


Choice: 


Figure 4-6: EBCDIC to ASCII Display Translation Table 


Notice that EBCDIC values 20 Hex to 3F Hex are 
all FFs. These are special codes called attributes 
used by the IBM host to format the screens. The 
IDEAcomm communications system uses these 
codes to control screen presentation. You cannot 
change these values from the FF value. In 
addition, you cannot place an FF anywhere else in 
the table. These are the only constraints placed on 
the entries you make. 
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Set Column Separator Character 


Since column separators (an attribute specific to 
IBM midrange displays) cannot be displayed by 
your PC or PS/2 display adapter, you have the 
option of determining what substitution character 
will be used in their place. The default setting is 
16 Hex, a vertical bar. 


From IDEACFIG type 4 on the Display Options 
menu. A prompt requests that you enter a two 
character hexadecimal number to use as the 
substitute character for column separators. For 
example, enter FE hex if you wish to use a 
rectangular block, or 2E hex if you wish to use a 
period. For hex codes, see the table at the end of 
Appendix A. 


5251 Display Type 


If you have purchased the IDEAcomm 5251 D 
product to use with the IDEAcomm card, from 
IDEACFIG type 5 on the Display Options menu 
and change this option to YES. 


Cursor Type 


This option allows you to configure the shape of the 
cursor to a block or underline. From IDEACFIG 
type 6 on the Display Options menu to use this 
feature. To change the option, use the space bar to 
select your choice, then press Enter. 
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Color Attribute Mapping 


Options are Color (emulation of a 5292 model 1 
display) or mono (emulation of a 5251 display). If 
you have an IBM Color Monitor and an IBM Color 
Display Adapter, you should set the Color Attribute 
Mapping option to Color. If you have a 
Monochrome Monitor and a monochrome adapter 
or an IBM Color Display Adapter, you should set 
the Color Attribute Mapping option to Mono. 


To change this option, from the IDEACFIG Display 
Options menu, type 7. 
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Additional Display Options 
Window Mode on Load 


From the Additional Display Options menu of the 
Display menu, select option 1 to specify whether 
windows will appear when you start emulation. If 
you choose NO, then when you enter emulation, 
the window option will not be active but can be 
activated by typing CTRL-W. If you choose YES, 
then when you enter emulation, the window option 
will be active. 


Video Adapter (Display Adapter) 


Special Display Adapters: IDEA provides full 132 
column, 3180 emulation for video adapters that 
support 132 columns. 


This option is available only if you have configured 
a host session as a 3180 display. Otherwise, use 
the CTRL cursor keys to scroll across a 3180 host 
session and view one part at a time. 


See page 4-5 for considerations on defining a 
special adapter. 
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Section V: 
Printing 


Note 


Before you load TWINAX, make sure the 
PC printer is selected and ready to print. 
If the host sends data while the PC printer 
is off, an error condition occurs. 


The term PC printer refers to the local 
printer for either a PC or a PS/2 series 
microcomputer. 


Installation of Printer 
Software 


Run the INSTALL program to install the printer 
software. If you wish to customize IDEAcomm to 
your printer, you can run the IDEACFIG program. 
(Customized configuration is discussed in Section 
VI.) However, INSTALL is the only program you 
need to run in order to use the emulation program 
if your printer is one of those listed by INSTALL. 
(See Section II.) 
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The Printer Control Panel 


This screen appears when you view an LU defined 
as a printer. Using the Printer Control Panel 
screen, you can change the status of the printer 
and monitor parameter settings and printer activity. 


PRINTER CONTROL PANEL 
Emulated Printer Type = nnnn 
PC Printer Type = mmmm LPT/COM/x 


OPTIONS: STATUS: 


Stop, Go Offline 
Suspend Printing ON Ready 
Cancel Print 
Host Printer Reset PC Printer Status 
Send PC String Error Check 
Form Feed 
Line Feed Change Font 
Test PC Printer 

Change Setup 

SELECT OPTION: 
Data Buffers Active 


| Output Data-[  ] Lpi 10 Cpi 


Lines/Page 080 Chars/Line 


Figure 5-1: Printer Control Panel Screen 


Options Available on the Printer 
Control Panel 


Stop, Go Offline — Type 1 at the SELECT 
OPTION field, and press Enter to start or stop the 
emulated printer. While the PC printer is printing 
host data, the normal PC print requests are rejected 
to avoid mixed printing. Use this option before hot 
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keying to DOS to print from DOS. To go back 
online, select this option again. 


Suspend Printing — Type 2 at the SELECT 
OPTION field, and press Enter to suspend printing 
temporarily. After this option is selected, the 
suspend printing message is replaced by a 
highlighted RESUME PRINTING. 


Cancel Printing — Type 3 at the SELECT 
OPTION field, and press Enter to terminate the 
printout. 


Host Printer Reset — Type 4 at the SELECT 
OPTION field and press Enter. This sends a reset 
command to the host that aborts the printing 
session, and puts the printer offline for the host. 
This option is also used to clear the Error Check 
indicator. 


Send PC String — Type 5 and press Enter. You 
are prompted for a number, 1 through 4. Press the 
number that corresponds to the desired Printer 
Setup string configured with IDEACFIG. (See page 
6-14.) 


Form Feed — Type 6 at the SELECT OPTION 
field and press Enter. This issues a form feed to 
the printer and sends the paper to the top of the 
next page. 


Line Feed — Type 7 at the SELECT OPTION 
field and press Enter. This issues a line feed to the 
printer that causes the paper to move down one 
line. 


Test PC Printer — Type 8 on the Printer Control 
Panel screen and press ENTER to start this test. 
This test is used to verify that the local PC printer 
is cabled and configured correctly. It also uses the 
Advanced Printer Configuration commands from 
Section VI if you choose to emulate a 5219 printer. 
You can use the test to verify that the printer 
command sequences have been configured correctly 
for your emulated printer type. See Appendix A 
for sample output from printer tests. 
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Indicators on the Printer Control 
Panel 


Ready — When the printer is online to the host, 
ON appears in this box. 


PC Printer Status -—— When the printer is online, 
ON appears in the box. When the printer is out of 
paper, PO appears in the box. 


Error Check — If error check is active, ON 
appears in front of the words Error Check and the 
printer goes offline. The type of error is displayed 
below the Output Data field (see Table 5-1). The 
Output Data field also displays a number 
corresponding to a system printer command (Table 
5-2). 


To clear the error condition select the Printer Reset 
option, then select the Online option to put the 
printer back online. 


Change Font — If a new font cartridge must be 
inserted in the printer while an application is 
running, then a font number may be configured as 
“Stop on font change.” (See Font Change in 
Section VI.) In this case, the Change Font 
indicator becomes active. The Output Data field 
displays the decimal number of the font to insert in 
the printer. The user should insert the new font 
cartridge and select the Online option from the 
Printer Control Panel. The command sequence will 
then be sent to the printer. 


Change Setup — This indicates a printer setup 
change. ON means change setup. ‘BL’ means the 
BELL command was received. The printer goes 
offline and the Output Data field displays one of 
the following numbers: 


001 = manual feed 
002 = tractor feed 
003 = automatic cut sheet feed 
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The user must change the feed type (if manual 
feed, insert the sheet) and put the printer back 
Online from the Printer Control Panel. 


Data Buffers Active — There are two 256 byte 
buffers. The number (0, 1, or 2) displayed in 
front of this status indicates the number of buffers 
presently active. 


If the number 1 or 2 is displayed but the 
information sent to the printer is not printing, the 
printer may be faulty or printing may be suspended. 


LPI (Lines per Inch) — The numbers in front of 
this status indicate the current lines per inch setting 
of the print job. 


CPI (Characters per Inch) — The numbers in 
front of this status indicate the current characters 
per inch setting of the print job. 


Lines/Page (Lines per Page)—— The numbers in 
front of this status indicate the current lines per 
page setting of the print job. 


Chars/Line (Characters per Line) — The 
numbers in front of this status indicate the current 
characters per line setting of the print job. 


The bottom line on the Printer Control Panel is the 
status line discussed in Section III. The status line 
items are active if they are highlighted. 
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Printer Error Messages 


The following tables provide information on the 
meaning of messages on the Printer Control Panel. 


Table 5-1: Output Data Field Definitions 


Error Change | Change 
Output Data | Check Error Message Font Setup 


Invalid Code INVALID SCS! 
CONTROL CODE2 


INVALID SCS 
PARAMETER? 


Command # 
in Table 5-2 


EXCEPTION 
CONDITION4 


GRAPHIC CHECK® 


Command # 
in table 5-2 


EBCDIC value 


Font number 


Change Setup: 
001=manual 
002=tractor 
003=cut sheet 


’ SCS = System Network Architecture Character String 


Invalid SCS Control Code--Invalid or unrecognized printer command 
received. Commands are listed in Table 5-2. 


Invalid SCS Parameter -- A printer command was received with an 
invalid parameter. For example, a command may be violating page 
boundaries. 


Check your printer configuration both on the host and in IDEACFIG. 
They must match. 


4 Exception Condition 1, 2, 3, 4 -- A 5219 printer command was 
received with invalid parameters. 


Graphic Check -- unprintable character received. 


If your printer configuration is correct, and you are 
still receiving an error message, contact your system 
administrator. If the system administrator cannot 
resolve the problem, call IDEA Technical Support 
for assistance and give them the number(s) or the 
error code(s) displayed. 
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Table 5-2: Printer Command Numbers 


Command 

New Line 

Carriage Return 

Line Feed 

Form Feed 

Print Position, Absolute Horizontal 
Print Position, Absolute Vertical 
Print Position, Relative Horizontal 
Print Position, Relative Vertical 
Transparent 

Set Character Distance 

Set Line Density 

Set Vertical Format 

Set Horizontal Tab Stops 
Horizontal Tab 

Begin Underscore 

End Underscore 

Superscript 

Subscript 

Begin Overstrike 

End Overstrike 

Backspace 

Set Horizontal Margins 

Justify Text Field 

Set Justify Mode 

Set Single Line Distance 

Set Horizontal Motion Index 
Set Vertical Motion Index 

Set Top Margin Error 

Justify Text 

Set Initial Conditions 

Set FID through GFID 

Set Indent Level 

Release Left Margin 

Set Line Spacing 

Set Presentation Page Size 

Set Vertical Margins 

Set Print Setup 

Required New Line 

Set Exception Action 

Space Command 

Page Presentation Media (multibin 
printing) 

Set Text Orientation (portrait/landscape 
printing) 
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Printing Screens (Local Print 
and PrintScreen) 


Use the PrintScreen function to copy the data 
displayed on the screen to a printer or disk file. 
Any serial or parallel printer attached to your PC 
or PS/2 can accept the screen data. With windows, 
only the screen for the active session is copied. 


The keys used for the PrintScreen function are 
Shift—PrtSc on the PC, XT, and AT keyboards. 
and Shift-PgUp on the Enhanced keyboard. 


When you press the PrintScreen key combination, 
the information displayed on your screen is sent to 
the location specified by the PRINT option on the 
Command Menu. The default is LPT1. 


If a disk file was specified, each time PrintScreen is 
entered the new information is appended to data 
already in the file. 


If the device or disk file is not accessible, the 
PrintScreen key does nothing. 


The PrintScreen feature does not affect the Printer 
Control Panel. Use the non-emulated Print Screen 
key on your PC or PS/2. 


You can also use the emulated Print key (F5 or 
PageUp) to print screens through your host. In this 
case, the host sends the printout either to its 
default system printer or to the printer you 
specified in a host command such as PRINTKEY. 
See your host operating system guide. 


The size of the Print Screen file depends on the 
type of display and mode of display (regular or 
wide screen): 


Display Model Bytes or Characters 
All 80 x 24 1968 
3180 (80 x 24) 1968 
3180 (132 x 27) 3618 
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Note 


For printouts of wide screens (132 x 27), 
you must have a printer that supports wide 
carriage or 17 characters per inch. 


Graphics screens (for example, from the 
BGU program) can only be sent to a 
printer. The printer must be set up for a 
display session emulating a 5292 Model 2, 
the session must use the GR5292 program 
described in Section IV, and the printer 
must be suitable for printing graphics (such 
as a Proprinter or Fujitsu). 
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Section VI: 
Configuring User 


Defined Printers 
ee 


This section explains how to configure a local PC 
or PS/2 printer to emulate a system printer with 
IDEAcomm 5251/Plus. 


For your convenience, IDEA has prepared 
configuration files for several widely used PC 
printers. If your printer is one of the choices on 
the INSTALL menu or the IDEACFIG Select PC 
Printer menu, all you need do is choose it. No 
additional configuring is required. If your PC 
printer is not on these menus, choose the User 
Defined option of IDEACFIG to set up the 
parameters you wish your printer to use. 


More technical users should refer to the separate 
Technical Reference Guide for details on the system 
printer commands that are supported. | 
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Defining Your Own Printer 


If your PC printer is one listed in the INSTALL 
program or the IDEACFIG Select PC Printer 
screen, the correct control sequences have already 
been configured for you in the IDEAcomm 
software. (The only exception is the 5292 
printing.) Simply select your printer on that 
screen. 


If your printer type is not listed, choose User 
Defined. Then when you have finished defining 
host sessions, go through the following steps: 


1. Type 4 on the IDEACFIG Main Options menu 
to display the Printer Options menu below. If 
necessary, the program prompts: Which 
printer session number do you want to 
change? Enter the session number from the 
top of the screen. After this, an arrow marks 
the session number of the printer you are 
currently configuring. 


Printer Options 


Select PC Printer 
5256 Printer Options 
4214/5224/5225 Printer Options 


5219 Printer Options 
5292 Model 2 PC Graphics Printer Options 
Exit to MAIN 


Choice : 


Figure 6-1: Printer Options 


2. From the Printer Options menu, first choose 


Select PC Printer. 


3. When you enter the Select PC Printer menu, 
you see a list similar to the following. 
A highlighted bar is displayed on the currently 
configured printer. Be sure that the bar is on 
the printer you want and press Enter. 
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Attached Printer Model Type 


'NEC 3550 Spinwriter parallel 
'IBM 5216 Wheelprint parallel 
1HP LaserJet serial (9600) 
1Okidata Microline 84 parallel 
‘IBM Color Printer parallel 
1IBM Quietwriter parallel 
1IBM Proprinter parallel 
2Epson FX-286e “IBM Emulation” parallel 
2Epson LQ-1000 parallel 
1User Defined Printer parallel 


1 Suitable for 5219 printer emulation. 
2 Suitable for 4214, 5224, and 5225 emulation. 


Figure 6-2: Select PC Printer Menu 


If your printer is close to one of those listed, 
choose the listed name and make changes. 
(NEC 3550 is a good general choice.) 
Otherwise, choose User Defined. 


4. In answer to the prompt, enter the name of the 
PC printer you want to define (for example, 
MINE), and press Enter. 


5. The next query is Change printer interface? 
The default printer interface is parallel. If your 
printer is serial, answer Y and, from the next 
screen, select the baud rate. 


Note on Serial Port Parameters 


When you choose a printer port of COM1 
or COM2, additional serial port settings are 
provided for the parameters listed. The 
serial port parameters as well as baud rate 
are initialized when TWINAX is loaded if a 
serial port is configured. These settings are 
used because they are the values used by 
the majority of serial printers: 
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Parity: none 
Stop bits: 1 
Bits: 8 


If the parameters used by your printer are 
different, select “serial (no baud).” 
TWINAX will not initialize the serial port 
parameters when it is first loaded. In this 
case, you must be sure that the port is 
already set up before loading TWINAX by 
using the DOS MODE command (refer to 
your IBM DOS manual). 


6. The list of PC printers appears. Press Esc to 
return to Printer Options (Figure 6-1). 


7. Choose option 2, 3, or 4, depending on which 
5250 series printer you want to emulate. Refer 
to Defining a xxxx Printer in this section. 


Note 


The model of printer you want must have 
been configured with IDEACFIG. You 
cannot, for example, choose option 4 
(5219) if no 5219 session is configured. 


8. If you will emulate a 5292 model 2 terminal 
and want to print its graphics on your local PC 
printer, select option 5. Refer to Setting up a 
Local PC Printer to Print 5292 Model 2 


Graphics in this section. 


9. You are asked to save the new file either when 
you start to define a second file or when you 
return to the Main Configuration Menu: 


Save changes to the xxx (Y/N)? Y <Enter> 


If you type Y, your changes are saved in the 
PRINTER.CMD file. These changes will not be 
configured or. saved in the actual configuration 
file, TWINAX4.UCM or TWINAX7.UCM, 
until you exit to DOS. If you type N, your 
changes are not saved. 
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Defining a 5256 Prithet 
The 5256 printer offers basic printer features. 


1. Follow steps 1 through 7 on the preceding 
pages. 


2. From the Printer Options Menu, choose 2 
(5256 Printer Options). The screen lists the 
entries used with a 5256 emulated printer: 


5256 Printer Options 


Set Forms 


Edit Printer Initialization String 
EBCDIC/ASCII Printer Translation 
Edit Printer Setup Strings 

Esc) Exit to Previous Menu 


Figure 6-3: 5256 Printer Options Screen 


These options are discussed with User Defined 
Features below. 
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‘Definirig a 4214, 5224, or 
5225 Printer 


All of these printers provide flexibility. They allow 
you to determine such features as characters per 
inch, lines per page, and forms length, and they 
are capable of printing graphics. The IDEAcomm 
emulation software can take advantage of these 
printing features provided your PC printer is 
capable of generating them. 


1. Follow steps 1 through 7 on pages 6-2 
through 6-4. 


2. From the Printer Options Menu, choose 3 
(4214, 5224/5225 Printer Options). The 
screen displayed lists the entries used with a 
4214, 5224, or 5225 emulated printer: 


4214/5224/5225 Printer Options 


Set Forms 
Edit Printer Initialization String 
EBCDIC/ASCII Printer Translation 


Edit Printer Setup Strings 
Set Characters per Inch (cpi) 
Set Lines per Inch (lpi) 

Set Graphic Commands 

Exit to Previous Menu 


Figure 6—4: 4214/5224/5225 Printer Options Screen 


These options are discussed with User Defined 
Features below. 
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Defining a 5219 Printer 


By using the 5219 printer, you can customize such 
printer parameters as vertical motion index, 
subscript, half line feed, right margin. This printer 
is especially useful in text and word processing 
applications. 


1. Follow steps 1 through 7 on pages 6-2 through 
6-4. 


2. From the Printer Options Menu, choose 4 
(5219 Printer Options). The screen displayed 
lists the entries used with a 5219 emulated 
printer. Choose the printer type you wish to 
emulate from the Printer Options menu. A 
screen is displayed providing all possible choices 
for the particular type of emulated printer: 


5219 Printer Options 


Set Forms 
Edit Printer Initialization String 
EBCDIC/ASCII Printer Translation 


Edit Printer Setup Strings 

Set Font Change 

Advanced Printer Configuration 
Exit to Previous Menu 


Figure 6-5: 5219 Printer Options Screen 


These options are discussed with User Defined 
Features below. 
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Setting up a Local PC or PS/2 
Printer to Print 5292 Model 2 


Graphics 


Using IDEACFIG, you can set up your attached PC 
printer to print color graphics. The only 
requirement is that you use a dot matrix PC printer 
with graphics support. 


1. Follow steps 1 through 6 on pages 6-2 through 
6-4. 


2. From the IDEACFIG Printer Options Menu, 
select 5 (5292 Model 2 PC Graphics Printer 
Options). Then define options 1 through 5, 
referring to your printer manual for the 
required information. 


5292 Model 2 PC Graphics Printer Options 


1) Set 9 Lines Per Inch Spacing Command 
2) Set Graphics Control Command 
3) Set Color Selection Commands 


4) Type of Ribbon Monochrome 
5) Current Printer Port Used 
Esc) Exit to Previous Menu 


Figure 6-6: 5292 Graphics Printer Screen 


1. 9 Lines per Inch Spacing Command 
Graphic printing requires 9 LPI printing. Enter 
the length and sequence of the command 
characters required to set the printer in 9 LPI 
mode. 


For example, if the 9 LPI command sequence 
for your printer is Esc&lnD, you must convert 
all characters except n to hex. (The n is the 
number of lines per inch, which here must be 
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9.) Use the table at the end of Appendix A. 
First enter the number of characters or bytes in 
the command (05); then enter the command 
sequence in hex (1B 26 6C 09 44). The entire 
command sequence is: 


05 1B 26 6C 09 44 


Graphics Control Command 

To print a graph, a PC printer must be set in 
Graphics Mode. Enter the command to put 
your printer in Graphics Mode. 


If the graphics command for your printer is one 
of the options listed (Esc K, Esc L, Esc Y, or 
Esc Z), just type the respective number. 
TWINAX fills in the character length and 
command sequence automatically. Otherwise, 
select 5 (User Defined Graphics Command) 
and enter your printer’s graphics command in 
hex. 


Note that Esc K allows 132 column printing, 
while Esc L, Y, or Z allows 80 column printing. 


Color Selection Commands 

For selecting each color (yellow, red, blue, and 
black), enter the length of your printer’s 
command and then the command sequence in 
hex. 


Type of Ribbon 

Use the space bar to select the type of printer 
ribbon (monochrome or color). Then press the 
Enter key to confirm your selection. 


Current Printer Port Used 

Use the space bar to select the port to which 
your printer is attached: COM1, COM2, 
LPT1, LPT2, or LPT3. Then press the Enter 
Key to enter your selection. 


Press the Escape key (Esc) to save your entries 
and return to the previous menu. 
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User Defined Features 


These are features of each emulated printer type. 
If you use a printer type configured by IDEA, you 
do not need to change these features. To access 


them, see Defining a 5xxx Printer above. 


Set Forms (Forms Length) 


Note 


If you do not fill in this screen, the forms 
length will be your printer’s current setting. 


Choose the printer type you wish to emulate from 
the Printer Options menu. A screen is displayed 
that provides all possible choices for the particular 
type of emulated printer. If the forms length 
choice is applicable to your printer type, it is 
displayed on this screen. (Refer to Defining Your 
Qwn_ Printer in this section.) Make sure that you 
have configured a host session for the printer you 
chose. 


Choose Forms Length from the displayed screen 
and the Forms Length screen is displayed. As the 
cursor is moved, the message that corresponds to 
that byte is displayed in the status message area of 
the screen. Information about the type of 
command the printer uses is conveyed to the 
emulation software by the first four bytes or fields 
shown on this screen. The actual command that is 
sent to the printer is shown by the last eight bytes 
on this screen. 


Note 


IDEAcomm software is designed to work in 
lines per page. If your printer provides a 
forms length command that is specified in 
inches OR lines, enter lines. Do NOT 
enter inches. 
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A prompt is displayed in the message area of the 
screen when the cursor is placed over a particular 
field. The following is a list of the prompts 
displayed (and examples for determining the entry 
information) when the cursor is in the field listed. 


Field #1 —- Command Length 

Enter the number of characters in the command 
sequence including parameter value. Enter 00 for 
no command. 


Example -- Determining Value of Field 1 

To determine the value you must place in field 1, 
check the manual that came with your printer. 
Field 1 should contain the Set Page Length value 
(this may be referred to by other names by other 
printer manufacturers). Determine the number of 
characters in the command sequence, including the 
parameter value(s). 


If, for example, Esc C nm is the Set Page Length 
command for your printer, you must first determine 
what n and m represent. In this example, n 
represents the page length in lines and m represents 
the page length in inches. The printer manual 
further indicates that if n is specified, the value of 
m must be zero or does not have to be entered. 
You should choose n since you must use page 
length in lines, so you would have 2 characters in 
the command sequence (ESC) and (C), and 1 
character in the parameter value (n). Since this is 
a total of 3, you would enter 03 in field 1. If you 
wish to recognize m as zero (an option this 
example allows) you would have 2 characters in the 
command sequence (ESC) and (C), and 2 
characters in the parameter value (n and m). In 
this case you would enter 04 in field 1. 


Field #2 -- Parameter Value Length and 
Position 

The first digit represents the parameter value length 
(1 for single byte and greater than 1 for string 
format). The second digit represents the position 
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in the command string for the start of the 
parameter value. Enter 00 for no parameter. 


Example —- Determining Value of Field 2 

The first digit in field 2 represents the parameter 
value character length. For the sequence ESC n 
m, enter 1 to indicate that a single byte is sent. If 
a string format is being sent, count the number of 
characters that make up the parameter value and 
enter that number (a number greater than 1). 


To determine the value of the second digit in field 
2, determine the location of the parameter value 
within the command/parameter sequence. In the 
sequence ESC C n m, n is in position 3. 
Therefore, 3 is entered as the second digit of 
field 2. 


Field #3 -- Base Value 

Base parameter value (value for a parameter of 0). 
This number will be added to any parameter value 
which is sent to the printer. For most printers, it 
is 0. 

Example -- Determining Value of Field 3 

If your printer manual says that the printer uses a 
base parameter value you must enter that value in 
hexadecimal in field 3. For example, if the base 
‘parameter value is @, you would enter 40 Hex. 
This means that regardless of how many lines the 
host indicates, an additional 40 Hex is to be added 
to that figure. Therefore, if 3 lines are specified, 
an additional 40 Hex is added making a total of 43 
Hex which is sent to the printer to specify 3 lines. 


Field #4 -- Separator Character 
Do not place an entry in this field. This field is 
not used. 


Fields 5 through 12 -— Command Sequence 
This is the command sequence from your printer’s 
manual. 

Example -- Determining Value of Fields 5 
through 12 

The information placed in fields 5 through 12 
represents the actual command sequence 
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transmitted to the printer. Only fixed characters in 
the command sequence should be entered here: do 
not enter parameter values. All remaining fields 
should contain zeros. Use the table at the end of 
Appendix A to convert to hex. Using the 
command characters ESC C n m from the above 
example, and converting the fixed command 
characters ESC and C to Hex, you would enter 1B 
(for ESC) in field 5, and 43 (for C) in field 6. 
Since there are only two fixed command characters 
in this example, the remaining fields display zeros. 


Edit Printer Initialization String 


From the Printer Options Menu in the IDEACFIG 
program, choose the printer you are emulating. © 
(Refer to Defining Your Own Printer in this 
section.) One of the options on the screen 
displayed is Edit Printer Initialization String. 


Information entered in this option is sent to the 
printer when TWINAX is loaded. Placing printer 
commands in this menu allows you to put the 
printer into the mode of your choice automatically. 


To delete an entry, move to the desired field using 
the cursor keys, then press the space bar. All 
fields to the right of the deleted field are shifted 
left. 


Check your printer manual for the code of the 
command mode you wish to use. For example, if 
you want to set the printer for bi-directional mode, 
determine the parameters your printer requires to 
execute this command. 


Suppose that your manual lists ESC U n as the 
command, and that the value of n can be 00, 01, 
02, or 03. Each option offers a different print 
mode. However, 03 is set for auto bi-directional 
mode; therefore, you want to set n equal to 03. 
Next convert the command to hexadecimal. ESC is 
1B Hex and U is 55 Hex. Starting at position zero 
on your screen enter the command: 1B 55 03. 
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If you have a second command to enter, begin it in 
the next unused field. In this example, since you 
already used fields one, two, and three to enter the 
first command, the second command would begin 
in field four. 


EBCDIC/ASCII Printer Translation 
Table 


Refer to Section IV for information on altering the 
EBCDIC/ASCII printer translation table. 


Edit Printer Setup Strings 


This screen allows you to enter as many as four 
command strings that you may want to send to the 
PC printer from the Printer Control Panel described 
in Section V. 


Use your PC printer manual to determine the 
ASCII hex code for each command. Then enter 
each command on a separate line. 


During emulation, you may use the PC Command 


Strings option on the Printer Control Panel to send 
one or more strings by number. 
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Set Characters per Inch 


To configure the characters per inch parameters for 
your particular PC printer, select the printer you 
are emulating from the IDEACFIG program’s 
Printer Options Menu. (Refer to Defining Your 
Own Printer in this section.) One of the options 
offered is Set Characters per Inch if it is available 
with your printer type. 


Determining Characters Per Inch: Read the 
manual supplied with your printer to determine the 
sequence of characters needed to set the various 
modes your printer supports. 


For example, if the CPI command sequence for 
your printer is Esc&InD, you must convert all 
characters except n to hex. (The n is the number 
of lines per inch.) Use the table at the end of 
Appendix A. The hex command sequence for 9 
lines per inch is then 1B 26 6C 09 44). 


You may find that there is no direct correlation to 
the density you need. In this case IDEA 
recommends that you use a mode that compresses 
a little more than the 10 or 15 characters per inch 
IBM uses. For example, use 17 CPI for 15. This 
way all the characters the host sends fit on one 
line. 


The IDEA printer software detects the format 
command from the host, determines the effective 
characters per inch, and sends the sequence of 
characters from the list of options that best matches 
the requested density. If the list is empty or there 
is no entry for the character density requested 
within a range of 2 characters per inch, the 
command from the host is ignored. 
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Add Entry: Add Entry adds a new horizontal 
command. Type 1 (Add Entry). Type the number 
of characters per inch you wish entered and press 
ENTER. Notice that the information entered is 
displayed temporarily above the words Select 
Option. Type the count value (the number of 
characters in the command code) and press 
ENTER. Type the command sequence beginning 
with the first byte you want sent. When you press 
the ENTER key after typing the command 
sequence, the system automatically sorts the 
information by the number of characters per inch 
and displays the added entry in its proper position 
on the screen. 


Delete Entry: Delete Entry allows you to erase a 
horizontal command. Type 2 (Delete Entry) and 
press ENTER. Type the number of the command 
you want to delete. When you press ENTER, the 
entry is deleted and the remaining entries are 
sorted and displayed in their proper positions. 


Change Entry: Change Entry alters information 
already displayed on your screen. Type 3 (Change 
Entry) and press ENTER. Type the number of the 
command you want to alter and press ENTER. 
There are two ways of entering changes. You can 
press ENTER after each value is typed, or you can 
use the TAB key to enter new and unchanged 
values. If you use the TAB key, you could, for 
example, change the Chars Per Inch field, Count 
field, and one byte of the Command Sequence 
field. After altering the first byte of the Command 
field, if you press TAB, the new changes are saved 
as well as the bytes in the Command field that were 
not changed. 
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Set Lines per Inch 


To configure the lines per inch parameters for your 
particular PC printer, choose the printer you are 
emulating from the Printer Options Menu in the 
IDEACFIG program. (Refer to Defining Your Own 
Printer in this section.) One of the options available 
on the screen displayed for that printer is Set Lines 
per Inch if it applies to your printer. 


Determining Lines per Inch: Read the manual 
supplied with your printer to determine the 
sequence of characters needed to set the various 
modes your printer supports. 


The IDEA printer software detects the format 
command from the host, determines the effective 
lines per inch, and sends the sequence of 
characters from the list of options that best matches 
the requested density. If the list is empty or there 
is no entry for the lines per inch requested within a 
range of 2 lines per inch, the command from the 
host is ignored. 


Refer to the discussion of Set Characters per Inch 


on the preceding page for how to enter command 
Sequences on the screen. 


Add, Delete, Change Entry: Refer to the 
discussion of Set Characters per Inch on the 


preceding page for how to modify entries. 
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Set Graphics Command 


To be able to emulate the graphics features of the 
4214, 5224, or 5225 you must configure one host 
session aS a printer and your PC printer must have 
the following capabilities: 


1. The printer must be able to print graphics as a 
series of 8 vertical dots. Many dot matrix 
printers print in this way. 


Note that printers that support raster graphics 
can not be used because they print graphics as 
a series of horizontal dots. An example of a 
raster printer is the Hewlett-Packard 
LaserJet™. 


2. The printer must be able to print text and 
graphics on the same line. 


3. The graphics command sequence supported by 
your printer must conform to the following 
format: 


ESC x nl n2 m1 m2 m3... 
where: 

@ ESC = command byte 1 
® x = command byte 2 


@ The total number of graphics characters 
printed equals n2 times 256 plus 
ni. 

@ The actual graphic data bytes (m1, m2, m3, 
...) follow n2. 


From the Printer Options Menu select 3 
(4214/5224/5225 Printer Options). The screen 
displayed lists the Set Graphic Commands option 
along with other options available for these printers. 


Check your printer manual for the correct graphics 
command. If the graphics command for your 
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printer is one of the options listed (Esc K, Esc L, 
Esc Y, or Esc Z), just type the respective number 
and TWINAX fills in the character length and 
command sequence automatically. Otherwise, 
select 5 (User Defined Graphics Command) and 
enter your printer’s graphics command. 


Note that Esc K allows 132 column printing, while 
Esc L, Y, or Z allows 80 column printing. 


If you choose the User Defined Graphics Command 
on the Set Graphics Command Menu, a screen is 
displayed that provides information on the graphics 
command format. You are prompted to enter 
command byte 1. If, for example, command byte 
1 is ESC, you would enter the hexadecimal value 
for ESC, which is 1B. The screen now prompts 
you to enter command byte 2. If, for example, 
command byte 2 is W, you would enter the 
hexadecimal value for W which is 57. 


You can change or configure only command bytes 
1 and 2 in the graphics command sequence. 
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Set Font Change 


To use this feature, from the IDEACFIG Printer 
Options menu type 4 (5219 Printer Options). 
(Refer to Defining Your Own Printer in this 


section.) 


This feature allows the emulation software to trap 
font change commands received from the host and 
send the appropriate escape sequences to the PC 
printer to enable it to print with the desired font. 


A table of font change commands lists a maximum 
of 10 entries. Five entries at a time may be 
viewed. Use the arrow keys to view the next five 
entries or the previous five entries. 


The font number is input in decimal and can be 01 
to 255. 


The font name can be a maximum of 16 
characters. 


The command sequence is a maximum of 30 
decimal characters. 


As you configure the Set Font Change menu, a 
prompt is displayed asking if you wish the printer to 
Stop on a font change so that you can change a 
font cartridge. If you select N, the Stop on Font 
Change is not active. If you select Y, when a font 
change is requested, the printer will go offline. 

You should change the font cartridge, then put the 
printer back online from the Printer Control Panel 


(refer to Printer Control Panel in Section V). 


6-20 Configuring User Defined Printers 


Advanced 5219 Printer Configuratior 
Commands 


These commands are accessible from the $219 


Printer Options screen. Release 5.0 includes the 
following commands: 


Superscript 

Subscript 

Reset WP Mode 

Set Left Margin 

Set Right Margin 

Half Line Feed Forward 
Half Line Feed Reverse 
Set Horizontal Tab Stops 
Justify Text Line 

Begin Underscore 

Reset Underscore Mode 
Begin Overstrike Mode 
Reset Overstrike Mode 
Set Vertical Motion Index 
Set Horizontal Motion Index 
Superscript/Subscript Off 
Bin #1 Select 

Bin #2 Select 

Bin #3 Select 

Envelope Bin Select 
Rotate Paper 0 (Portrait) 
Rotate Paper 90 (Landscape) 


Use the PgDn and PgUp keys to view all of the 
options. 


To emulate the features of a $219 printer, your PC 
printer should have the following features: 


1. Printer command strings must not be more than 
8 bytes long. 


2. Parameter values in a command string may be 
in single byte format or in decimal character 
String format, but only 1 parameter value may 
be in a command string except for the Set 
Horizontal Tab Stops command. 
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3. Printer command strings must be capable of 
including parameters. For example, a printer 
whose set left margin command is “set margin 
at current position” cannot be used. The 
command string must be able to support a 
format such as “set margin at column n.” 


4. For full 5219 printer emulation the printer must 
support the following commands: 


— Backspace 

—— Forms Length 

—— Superscript or Half Line Feed Reverse 
— Subscript or Half Line Feed Forward 
— Set Left Margin 

— Set Right Margin 

— Set Vertical Motion Index 

— Set Horizontal Motion Index 


Before you begin filling in the actual menu on your 
PC or PS/2 screen, make sure you have all the 
information you require. Consult your printer 
manual for the required command sequences for 
the word processing functions you wish to perform. 


Keep in mind the following list of various word 
processing functions that may be performed and the 
necessary printer command sequences that must be 
configured. 


The command sequences entered on the Advanced 
Printer Configuration menu are configured in 
TWINAXn.UCM. They are stored in the 
PRINTER.CMD file and will automatically load 
when you select that printer in the future. 
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Table 6-1: Printer Commands Needed for 5219 Word Processing 


Function 

Horizontal Margins 
Vertical Margins 
Variable Forms Length 
Tab Stops* 


Variable CPI 
Variable LPI 
Superscripting* 
Subscripting* 


Text Justification * 


Underscoring* 


Overstrike/Highlight* 


* Optional 


Printer Commands Required 
Set Left and Right Margins. 
Set Vertical Motion Index. 
Set Forms Length. 


If the printer supports tab stops, then Set 
Horizontal Tab Stops must be configured. 
Otherwise the emulation software will 
maintain tab stops. 


Set Horizontal Motion Index. 

Set Vertical Motion Index. 

Superscript or Half Line Feed Reverse. 
Subscript or Half Line Feed Forward. 


Set Left and Right Margins. If the printer 
supports text justification, then Justify 
Text Line must be configured to enable 
justification and Reset Word Processing 
Mode to disable justification. If this is 
not done, the emulation software will 
justify text by using the Set Horizontal 
Motion Index command. 


If the printer supports underscore, then 
Begin Underscore Mode and Reset 
Underscore Mode must be configured. 
The printer must support backspace if it 
does not support underscore. 


If the printer supports overstrike, then 
Begin Overstrike Mode and Reset 
Overstrike Mode must be configured. 
The printer must support backspace if it 
does not support overstrike. 


Note 


Generally the subscript or superscript command actually performs a half line 
feed forward and may be issued continuously to advance down the paper. If 
your printer operates this way, then you do not need to configure the subscript/ 
superscript OFF command. If your printer operates so that a subscript 
command brings the print position to the subscript position, then you will need 
to configure the subscript/superscript OFF command as well as the subscript and 


superscript commands. 
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Filling In the Advanced Printer 
Options Screen 


From the IDEACFIG Printer Options screen type 4 
($219 Printer Options). The screen displayed lists 
the Advanced Printer Configuration option along 
with others available for 5219 emulated printers. 


Highlighted messages are displayed in the status 
message area of the screen when the cursor is 
moved into a particular field. The following text 
lists the field and the message displayed. 


The first four fields in the Advanced Printer 
Configuration menu convey the type of command. 
The next eight fields convey the actual command. 
Be sure that you fill in all applicable fields using 
hexadecimal. 


Field #1 -- Command Sequence Length 

Enter the number of characters in the command 
sequence including any parameter values. Enter 00 
if your printer does not support the command you 
are trying to configure. 


Example: Set Horizontal Tabs — This command 
is used to set tab stop positions. When determining 
the parameter value for this command, be careful. 
The parameter value may consist of multiple digits 
with each digit being counted as a separate value. 
For example, to set a single tab stop, your printer 
may require a sequence such as the following: 


ESC HT nl n2 n3 CR 


where: 


ESC HT = Load Horizontal Tabs command 
(number of command characters = 2) 


nl n2 n3 = a 3-digit number for a single tab stop 


CR = End of command sequence (number of 
command characters = 1) 


The total number of command and parameter value 
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characters in this command is 6. Therefore, you 
would type 06 in Field 1. 


Field # 2 -—— Parameter Value Length and 
Position 

The first digit represents the length of the 
parameter value in the command sequence (1 for a 
single byte value and greater than 1 if specified in 
string format). The second digit represents the 
starting position in the command sequence for the 
parameter value. Notice that not every command 
has a parameter value to enter. For example, 
Superscript and Subscript commands have 
command sequences but no parameter values. 


Using the example Set Horizontal Tabs previously 
used for the Field 1 entry, the Parameter Value 
Length and Position are determined as follows: 


ESC HT nl n2 n3 CR 


Where: 


ESC HT = Load Horizontal Tabs command 
(number of command characters = 2) 


nil n2 n3 = a 3 digit number for a single tab stop 


CR = End of command sequence (number of 
command characters = 1) 


The tab stop position consists of a 3—digit number. 
Therefore, the first digit of field #2 is 3. 


The parameter value in this example begins at 
position 3 because it comes after ESC HT which 
take up positions 1 and 2. Therefore, the second 
digit in Field #2 is 3. 


In this example, you would enter 33 in Field 2. 


FIELD #3 -—— Base Parameter Value 

Base parameter value (value for a parameter of 0). 
This is a number that is added to any parameter 
value before the command sequence is sent to the 
printer. For most printers, it is 0. 
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For example, your printer may have a Set Left 
Margin command specified as: 


ESC Un 
where n = 40 Hex for a flush left margin. 


In this example 40 Hex is entered in Field #3. If 
a left margin setting of column 3 is desired, 40 Hex 
is still entered in field 3, but that value is added to 
the number entered elsewhere as your desired 
margin (in this example the number is 3) making a 
total of 43 Hex which is sent to the printer to 
specify a margin setting at column 3. 


The base value is always entered in this field, 
regardless of the total desired value. 


Field #4 -- Separator Character or Motion 
Index Units 

Separator character between multiple parameter 
values. Enter 00 for no separator value. This field 
is used for a separator character only as part of the 
Set Horizontal Tabs command. As an example, 
some printers require that tab stop positions in the 
command sequence be separated by a comma (,). 
You would enter the ASCII value for a comma, 
which is 2C hex. 


Example: Set Horizontal Motion Index 

To determine this value, read your printer 
specification manual. Look for Horizontal Motion © 
Index, HMI or the equivalent. As an example, if 
your manual shows 1/120 inch, you must determine 
the Hex value for 120. Since the Hex value for 
120 is 78 Hex, you enter 78 in this field. 


Fields #5 through #12 -- Printer Command 
Sequence 

Enter all of the fixed values in the command 
sequence. All parameter value positions in the 
command sequence should be filled in with zeros if 
not used. Examples are in the Set Forms Length 
discussion earlier in this section. 
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Section VII: 

File Transfer and 
Virtual Disk 
a 


TWINAX software allows IDEAcomm to be used 
with IBM System 3X file transfers, including the 
following from IBM: 


@ IBM PC Support/36 ($727-WSI) 
@ IBM PC Support/38 (5714—PC1) 


The IDEAcomm software is also compatible with 
many third party file transfer packages, such as: 


@ Decision Link by Laguna Laboratories, Inc. 
@ Smart Link by Computer Associates, Inc. 
@ ETU by Emerald, Inc. 


@ Omnilink by On-line Software International, 
Inc. 


Note 


To use PC Support with the AS/400, you 
need the IDEA driver for the AS/400 that 
comes with the IDEAcomm 5251/Plus 
hardware. See the hardware manual. 


TWINAX software is also compatible with 
IDEAlink, IDEA’s own file transfer 
package, which is described in the 
accompanying IDEAlink manual. IDEAlink 
does not require the use of any features 
described in Section VII. 
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Prerequisites 
System 3X Level: 
PC Support must be installed on the host. 


Microcomputer Level: Configuring a Host 
Session with IBM Transfer Capability 


With IDEAcomm 5251 (the 4 LU product), when 
you configure your host display sessions with 
INSTALL or IDEACFIG, be sure to configure one 
of them for IBM compatibility by answering YES to 
the IBM transfer package question. This allows 
you to use this host session with an IBM file 
transfer package. See Section II. 


With IDEAcomm 5251/Plus, no special 
configuration is necessary. 


7-2 File Transfer and Virtual Disk 


System 36 Examples 


Assume that you are working with a PC or PS/2 
with one diskette drive and one hard disk. The 
virtual diskette declared is A, and the emulation 
software is in subdirectory TWINAX of the hard 
disk C. 


Initial Installation - SSP Release 5.1 
IBM’s file transfer programs, PC Support/36 and 


PC Support/38, require that software be installed on 
the System 3X and on the PC or PS/2. In Release 


5.1 the files necessary for PC Support/36 are 
shipped on a diskette by IBM. 


1. Insert the IBM diskette in drive A and type: 
INSTALL <Enter>. 


2. Choose the option ‘Emulation.’ In answer to 
the prompt, specify the fixed disk and drive 
directory on the PC to which files will be sent. 
(The default is C:\PCS36.) 


3. INSTALL displays a menu describing the four 
emulation programs of IBM and proposes 
option 5 (Other emulation program). Select 
option 5. 


4. INSTALL then asks the name of the emulation 


program. Answer TWINAX.EXE (be sure to 
type in the .EXE). 


5. INSTALL asks for any parameters. Enter R 
with release 5.0 or higher of IDEAcomm; with 
release 4.0, enter G/R. 
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S/36 Initial Installation -— SSP Release 
5.0 


In Release 5.0 the files necessary for your 
microcomputer are shipped on an 8 inch diskette 
by IBM. You must transfer them to the System 3X 
host, and then download them to the PC or PS/2. 


This software creates on the host system a virtual 
diskette of 180 KB called #IWPCLD1 and a virtual 
disk of 2780 KB called 4IWPCLD2. The virtual 
diskette will contain the programs that the PC or 
PS/2 must use to access the PC Support programs 
located on the virtual disk. 


You should transfer the programs on the virtual 
diskette to the PC or PS/2 by declaring an extra or 
“virtual” diskette on the PC or PS/2, using IDEA’s 
diskette driver ADDVDSK. 


1. Run ADDVDSK (described at the end of this 
section). 


2. Start emulation (TWINAX) and log on to the 
system, so that you see the main menu. 


3. On the command entry line, type: 
IWDOWNL 


(Be sure that ADDVDSK has been run.) 


4. An operating menu appears. Enter Shift—Shift 
or Alt-—Esc to return to DOS. 


5. From drive C: goto A: (the virtual diskette) 
and enter DIR <Enter>. Compare the list of 
files that appears with the IBM documentation. 


6. If you wish to install your PC Support files in a 
particular directory on the hard disk, create this 
directory now if it does not exist. When done, 
move back to virtual drive A and execute the 
command: 
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COPYLINK C:dirname 


where dirname is the directory for the PC 
Support files. This batch procedure copies to 
the current default directory on your disk the 
files necessary for daily use of PC Support/36. 
It also installs the virtual disk driver VDSK.SYS 
automatically in the boot directory and enters 
its name in the file CONFIG.SYS. This should 
be in one of the following forms: 


DEVICE = VDSK.SYS 
DEVICE = FSDDX.SYS (for shared folders) 
DEVICE = FSDD.SYS (for shared folders) 


Note 


The files on drive I of the System/36 
contain DOS batch files. Instead of 
running COPYLINK, you may use the DOS 
command COPY *.* to copy all files into 
the target directory for later use. Then hot 
key back to the emulation session. If you 
do this, however, you must copy the file 
VDSK.SYS, FSDD.SYS, and FSDDX.SYS 
to the root directory and add it to 
CONFIG.SYS. 


Once COPYLINK is ended, return to drive C: 
and enter Shift—Shift to return to emulation. 
Sign off the session, return to the sign—on 
screen, exit emulation, and reboot the system. 
Watch the screen to assure that the Support 3X 
virtual disk facility loads on boot-up. 
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Everyday Startup (5.0 and 5.1) 


1. 


With Release 5.0, reboot the PC, which loads 
the virtual disk driver, and go into emulation 
with TWINAX <Enter>. 


With Release 5.1, instead of rebooting, run 
LINK36, which loads emulation. 


Go to the principal help menu (MAIN), then 
return to DOS with Shift—Shift. 


From DOS on drive C in the directory where 
you copied your PC Support files, enter: 


LINK36 <Enter>. 


The router is loaded on the PC side; the 
prompt I> appears instead of C>. You are now 
in communication with the virtual disk 
#IWPCLD2, which contains all the programs 
necessary for Support/36. 


Copy if necessary all the programs onto your 
hard disk (see IBM documentation). 


Before leaving PC Support/36, remember to 
stop the router with the command STOPRTR 
or STOPRTR /F <Enter>. 
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System/38 Example 


Assume that you are working with a PC or PS/2 
with one diskette drive and one hard disk. The 
virtual diskette declared is A, and the emulation 
software is in subdirectory TWINAX of the hard 
disk C. 


Initial Installation —— Release 8.0 


IBM’s file transfer program PC Support/38 requires 
that software be installed on the System 38 and on 
the PC or PS/2. 


This software creates on the host system a virtual 
diskette of 180 KB and a virtual disk of 2780 KB 
called, respectively, QIWPCLD1 and QIWPCLD2. 
The virtual diskette will contain the programs that 
the PC or PS/2 must use to access the PC Support 
programs located on the virtual disk. 


You should transfer the programs on the virtual 
diskette to the PC or PS/2 by declaring an extra, or 
“virtual” diskette on the PC or PS/2, using the 
IDEA diskette driver ADDVDSK. 


A. If you have not already done so, run 
IDEACFIG to be sure the display type, station 
address, keyboard type, file transfer option, and 
starting memory addresses are correct. (Specify 
Drive A as the virtual drive.) 


B. If you are using a hard disk, log onto the 
directory that contains TWINAX.EXE. 


1. Start emulation (TWINAX). Enter Shift—Shift 
to return to DOS. 


2. From DOS, run ADDVDSK (see the end of 
this section). 


3. Use Shift-Shift to return to emulation. Log 
onto the System/38. 
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4. Type: 
ADDLIBLE QIWS <Enter> 


You should see either the message library list 
changed or QIWS is already added. 


5. From the System/38 Programmers Menu or 
Command Entry Menu, type: 


CALL QIwDOWNL 


The screen displays directions relevant to IBM’s 
emulation software. 


6. Enter Shift—Shift to return to DOS. You 
should see the prompt C>. 


7. From drive C: go to A: (the virtual diskette) 
and enter DIR <Enter>. (There should not be 
a diskette in drive A.) You will hear clicking 
until all files are listed. Compare the list of © 
files that appears with the IBM documentation. 


8. If you wish to install your PC Support files in a 
particular directory on the hard disk, create this 
directory now if it does not exist. When done, 
move back to virtual drive A and execute the 
command: 


COPYLINK C:dirname 


where dirname is the directory for the PC 
Support files. This batch procedure copies to 
the current default directory on your disk the 
files necessary for daily use of PC Support/38. 
It also installs the virtual disk driver VDSK.SYS 
automatically in the boot directory and enters 
its name in the file CONFIG.SYS. This should 
be in one of the following forms: 


DEVICE = VDSK.SYS 
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Note 


The files on drive I of the System/38 
contain DOS batch files that enter 
commands and load programs into the 
System/38 programmers Menu. Instead of 
running COPYLINK, you may use the DOS 
command COPY *.* to copy all files into 
the target directory for later use. Then hot 
key back to the emulation session. If you 
do this, however, you must copy the file 
VDSK.SYS, FSDD.SYS, or FSDDX.SYS to 
the root directory and add it to 
CONFIG.SYS. 


Once COPYLINK is ended, return to drive C: 
and enter Shift-—Shift to return to emulation. 
Sign off from the session on the System/38. 
Reboot the PC before using PC Support. 
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System/38 Everyday Startup 


1. 
Zz. 


3: 


Go into emulation with TWINAX <Enter>. 
Sign onto the System/38. 

Type: 

ADDLIBLE QIWS <Enter> 


You should see either the message library list 
changed or QIWS is already added. 


Return to DOS with Shift—Shift. 
From the DOS directory with TWINAX, enter: 
LINK38 ' <Enter> 


The router is loaded on the PC side, then the 
screen changes into emulation and the 
procedure BGNIWSSRV appears on the screen, 
starting the router on the $38. The screen 
returns to DOS with the prompt I> instead of 
C>. You are now in communication with the 
virtual disk #IWPCLD2, which contains all the 
programs necessary for Support/38. 


Copy if necessary all the programs onto your 
hard disk. (See the IBM documentation.) 


Before leaving PC Support/38, if TOPC has not 
done this, remember to stop the router with the 
command ENDRTR Y,FORCE <Enter>. 


Note 


On a System/38, IDEA recommends 
permanently adding QIWS, the library 
containing PC Support/38, to the user’s 
library list. This avoids using ADDLIBLE 
QIWS before each use of PC Support and 
permits future Program Changes to be 
applied to PC Support/38 if necessary. 
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IBM File Transfers 


For information on using IBM file transfers, refer 
to the appropriate IBM manual. If the IBM file 
transfer you have uses a virtual disk, read the rest 
of this section. 


The IDEA Virtual Disk 
Driver (ADDVDSK) 


Setting up the Virtual Disk Driver 


Some IBM file transfers make use of a virtual 
drive. IDEA provides access to this feature in both 
the IDEACFIG program on the User Interface 
Options screen, and in emulation from the 
VIRTUAL option on the Command Menu. Both 
screens include the following three items: 


Virtual Floppy Drive 


You may select drive A through D as a virtual 
drive. If you are using an AT, configure only 
Drive A as the virtual drive. 


Virtual Floppy Host Session 
Select any LU configured as a display. 


Virtual Floppy Timeout 


Host computers vary significantly in the amount of 
time they take to respond to requests from users. 
Therefore you can set the timeout to correspond 
with the performance of the connected host. You 
are allowed to change a value for this entry only if 
a virtual drive is configured. 


Note 


If the timeout interval set is long and 
transfer is not executing correctly, you are 
not able to detect this condition until the 
timeout expires. If the timeout interval set 
is too short, false timeouts may occur that 
reduce the effectiveness of the transfer. 
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Switch Settings on the IBM PC Mother Board 


If you have a one diskette system and no hard 
disk, you can change the switch settings in your PC 
or XT to configure another drive (B). Refer to 
your IBM Guide to Operations manual for 
information on changing IBM mother board switch 
Settings. 


Do not use drive B on the AT as your virtual drive. 


Running the Virtual Disk Driver 


If your IBM file transfer program uses a virtual 
disk, first use IDEACFIG or the VIRTUAL 
command from the Command Menu to specify the 
session number and drive for the virtual disk. 
Then, to run the virtual disk driver, from DOS 
enter: 


ADDVDSK <Enter> 
One of the following messages should appear: 


_@ TWINAX virtual disk driver installed 

The virtual disk driver program has been 
loaded and will handle requests to the drive 
indicated as the virtual drive in IDEACFIG. 


e® TWINAX not active, virtual disk driver not 
installed 
You must load emulation with the command 
TWINAX before loading the virtual disk driver. 


@® TWINAX virtual disk driver already installed 
The virtual disk driver program has already 
been installed. 


This program must be installed every time you load 
TWINAX. You can include it in a batch file 
similar to the following: 


TWINAX R 
ADDVDSK 
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Using the IDEA Virtual Drive 


ADDVDSK emulates software commands usually 
performed on disk drives. For example, you can 
use the DOS commands COPY, TYPE, or DIR with 
the virtual drive. ADDVDSK intercepts the 
software commands, relays them to the IBM System 
3X host computer and returns the host’s results to 
the PC or PS/2. To the PC or PS/2, the software 
resembles a disk drive. 


When anything goes through the virtual drive you 
hear intermittent clicks. These let you know that 
your virtual drive is being accessed. 


ADDVDSK has shared access to a microcomputer 
drive when you are in emulation mode and file 
transfer is running on the host. With a two 
diskette system or a hard disk system, specify drive 
B and ADDVDSK intercepts the references to drive 
B and checks to determine if the host is ready to 
accept them. If the host is not ready, the 
commands are passed on to the real diskette drive. 
In this way, you can share a drive between the host 
and your microcomputer. 


Do not use drive B on the AT as your virtual drive. 


Use the command REMVDSK to remove the 
virtual disk software from memory when you no 
longer need it. 
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Appendix A: 
Troubleshooting, Error 


Messages, and Charts 
ee | 


Overview 


This section includes: 


e A list of symptoms and corrective action for 
troubleshooting IDEAcomm 


@ Diagnostics programs 
@ Error messages 


@ ASCII hex codes for display and printer 
characters 


Troubleshooting Tips 


If you are having difficulty using the emulated 
printer, display, or file transfer, it may be due to 
the configuration of the [DEAcomm hardware or 
software. The following text provides a description 
of symptoms and corrective action. 


Emulation 


If emulation cannnot be loaded, or cannot be made 
resident: 


—— Determine whether any other programs are 
active. Make these programs non-resident 
(if necessary, by powering off the PC and 
rebooting) and restart TWINAX. 


— If an application uses the IBM API and you 
have IDEAcomm 5251 (the 4 LU product), 
be sure that IBM XFER has been selected 
for that LU in IDEACFIG. 
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Display 

1. The cursor remains in the top right corner of 
the screen. (You are not in communication 
with the IBM midrange.) The letters SA 


(system available) are flashing or are not 
highlighted. 


— Verify that the TWINAX card is terminated 
correctly. See Section IV of the hardware 
manual. 


— Verify that the IDEAcomm TWINAX cable 
locking mechanism is correctly connected to 
the TWINAX run. Also check the other 
end of the connection. The mounting 
screws of the 15—pin connector should be 
tightened with a screwdriver. See the 
hardware manual. 


— Swap the IDEAcomm twinaxial cable and 
connector with a known good cable and 
connector. 


— Verify that this junction of the TWINAX 
allows another device to come up 
successfully. 


—— Verify that the station address in 
IDEACFIG is that expected by the host. 


2. The cursor is displayed in the middle of an 
otherwise blank screen. 


— Verify the IDEAcomm board addresses on 
both Switch Bank 1 (I/O Address) and 2 
(Memory Address), if applicable. The 
switch settings must match the settings 
configured in IDEACFIG. 


3. Your emulated display is normal but one or 
several workstations down line from the 
microcomputer are offline. 


— Check the termination switch on the 
IDEAcomm card or T-connector_as well as 
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any external terminators on the TWINAX 
cable run. The cable run should be 
terminated only at the end of the run. 


— Verify the station address that each device 
is using. Each station address must be 
unique. 


The cursor remains in the top left corner of the 
display. (You are in communications with the 
IBM midrange.) The letters SA are highlighted 
in the bottom left corner of the screen. 


— Verify that the station address for this 
device is a valid station address. 


— From the system console check to be sure 
you are varied on and that there are no 
outstanding messages. 


Graphics characters blinking and non-blinking 
cover the screen as soon as you go into 
emulation. 


— Turn off the PC or PS/2 and check to be 
sure that the IDEAcomm card is seated 
correctly. 


— Turn off the PC and remove the 
IDEAcomm card to verify switch bank 
addresses on both switch bank 1 (I/O 
Address) and 2 (Memory Address). The 
Switch settings must match the settings 
configured in IDEACFIG. 


When you send printed output to the display, 
such as CATALOG or LISTLIBR, there is a 
display station error. 


-—— The host may have this session configured 
as a 3180 (wide screen), while your 
microcomputer may have it configured as 
another display type. 
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8. You are using a monochrome monitor and an 
IBM color display adapter, and your screen 
display is not crisp and clear. 


— Run the TWINAX diagnostic program 
described in this appendix. 


— Make sure Color Attribute mapping in the 
IDEACFIG Display Options menu is set to 
monochrome. 


9. The words NO LUs CONFIGURED, TWINAX 
ABORTED appear on your screen. 


— No host session (LU) may be configured in 
IDEACFIG; check IDEACFIG for a host 
session. 


—If a host session is configured, check to see 
if the device and address or the configured 
host session and address are being used by 
another workstation. 


10. Miscellaneous problems: 


— Verify that the correct display adapter is 
chosen in the IDEACFIG file. 


—- Monochrome graphics display adapters 
should be selected as color adapters. 


— 5250 display type should be chosen in 
IDEACFIG only if a 5251-D board is being 
used. 


Keyboard 


_-- Verify that the correct keyboard has been 
chosen in IDEACFIG. 


Windows 


1. You configured windows, but when you press 
Ctrl—W no windows appear. 
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— Use the Command Menu to check that 
your current host session (LU) is one of 
the windows configured. 


Virtual Disk 


1. You cannot access the Virtual Disk. 


— Verify Switch #7 and #8 settings on the 
IBM PC mother board. See the PC 
manual. 


— Verify that the virtual disk is configured 
correctly in IDEACFIG and that you are at 
the main menu of file transfer before hot 
keying to DOS to use the virtual disk. 


2. Virtual disk appears to be configured correctly; 
however, DISK ERROR READING message 
occurs while you are using the virtual disk. 


— Increase the timeout value, using 
IDEACFIG or the VIRTUAL command 
from the Command Menu in emulation. 


Printer 


1. The emulated printer does not print. 


— Go to the Printer Control Panel. (Press 
CTRL-L to toggle between host sessions.) 
Look at the status. Both READY and PC 
PRINTER STATUS should be ON. On the 
status line, SA should be highlighted and 
not blinking. Check for any other error 
codes. 


—— Verify that the PC printer is physically 
online by checking the online status light on 
the front of the printer. 


—— Verify that there is a printer configured in 
IDEACFIG, and that the station address 
matches that expected by the host. 
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— Verify that the spool writer has been started 
by the host. On the System/36 or 
System/34, enter: 


START PRT, <printerID> 
On the System/38 or AS/400, enter 


STRPERTWIR DEV (printerID) OUTQ 
(outputque) 


— The default parameters send print requests 
to LPT1. If your printer is not set up to 
use LPT1, you must note the correct port 
in IDEACFIG (see Section II). 


— Verify that the printer prints locally (from 
DOS, press Shift PrtSc); if so, run the 
TWINAX diagnostic program described in 
this appendix. 


—— Use the test option on the Printer Control 
Panel screen. 


— Verify that the print job is being routed to 
the correct printer. 


— Run the System 3X Test Request diagnostic 
program (page A-13). 


2. The emulated printer does not print correctly. 


—— If you are not using one of the printers 
configured by IDEA, you may have entered 
incorrect control characters in the 
IDEACFIG emulation program (Section 
VI). Consult your printer manual. 


—— Verify that the printer chosen in 
IDEACFIG matches the printer physically 
attached at that address. 


3. Superscript and subscript printing do not appear 
to work correctly. 
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— Verify that the printer is configured as a 
§219 both on the host and in IDEACFIG. 


— Verify that subscript/superscript or half line 
feed forward/reverse commands are 
configured in the Advanced Printer 
Configuration menu in IDEACFIG. 


— Run the Printer Control Panel printer test. 
If “superscript” seems to be printed 
correctly but the words “normal” and 
“subscript” appear on the same line, then 
your printer may support an absolute 
subscript and superscript position mode. If 
this is the case, your printer will have a 
command string called Set 
Subscript/Superscript OFF command. This 
command should be configured for the 
superscript/subscript OFF command in the 
Advanced Printer Configuration menu in 
IDEACFIG. 


On the HP LaserJet series, the top or bottom 
two lines do not print. 


— The IDEA printer file for this series sets 
the top line to 0 in the initialization string. 
If possible, you should allow more margin 
at the top of the page. Otherwise, change 
the initialization string for this printer file to 
all zeros. See Section VI. 


Character or line density does not change 
correctly. 


— The printer must be configured as a 5224, 
5225, or 5219 printer. 


— For a user defined printer, the correct 
control characters for density must be 
entered in IDEACFIG. 


—— The host may be sending incorrect values. 
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Printer Diagnostics 


The Printer Tests from the Control 
Panel 


When the Test PC Printer option is chosen, the 
host is checked to see if data is being transmitted. 
If nothing is being transmitted, the host printer is 
shut off. 


As this diagnostic is executing, the status indicators 
on the Printer Control Panel screen reflect the 
current status. 


If you wish to terminate an active test, press any 
key after the Select Test message is displayed. 
When the test mode is exited, the host printer 
Ready status is returned to the state it held prior to 
executing this test. 


Since there are several system printer types, the 
output that appears on the printer depends on 
which of the types is configured. Sample outputs 
are shown on the following pages. The following 
disk files must be present in the directory with _ 
TWINAX: 


P5256.TST 
P522X.TST (for 5224/5225 emulation) 
P5219.TST 
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OBWAU AWN 


IDEAcomm 5251 - 5256 Printer Diagnostic 
Version 1.00 


TIXIIIIIIXIIITIIXLITIIIILIIIIIIIIIITIIIIIIIIIIIIITIIIIIIIINIIIIIIIIIIIIIII 
I It 
: II DDDDDD EEEEEEE AA II 
I D E A A II 
I D E 
II I D EEEEE AAAAAAAA II 
I D E 
I 
I 


oo0oo9o 


D E A A IT 
I DDDDDD EEEEEEE A A II 
II II 
LITIIQIIIIIIIIIVITIIIIIIIIIIIIIIIIILIIIILIXLILIIIIIIIIILIIIIIIIIIIIIIIIIIIII 


ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 #$%2G(+)-/*#\<@>(!) abcdefghijklmn 
BCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 #$%?6(+)-/*\<@>(!) abcdefghijklmno 
CDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 #SB?2&(+)-/*\<@>(!) abcdefghijklmnop 
DEFGHIJKLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!) abcdefghijklmnopq 
EFGHIJKLMNOPQRSTUVWXYZ 0123456789 #$%?6(+)-/*\<@>(!) abcdefghijklmnopqr 
FGHIJKLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!) abcdefghijklmnopqrs 
GHIJKLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!} abcdefghijklmnopqrst 
HIJKLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>({!)} abcdefghijklmnopqrstu 
IJKLMNOPQRSTUVWXYZ 0123456789 4#$%B?&(+)-/*\<@>(!) abcdefghijklmnopqrstuv 
JKLMNOPQRSTUVWXYZ 0123456789 #$%?6(+)-/*\<@>(!)} abcdefghijklmnopqrstuvw 
KLMNOPQRSTUVWXYZ 0123456789 #$%?6(+)-/*\<@>(!) abcdefghijklmnopqrstuvwx 
LMNOPQRSTUVWXYZ 0123456789 #$%?6(+)-/*\<@>(!) abcdefghijklmnopqrstuvwxy 
MNOPQRSTUVWXYZ 0123456789 #$%?76(+)-/*\<@>(!) abcdefghijklmnopqrstuvwxyz 
NOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!} abcdefghijklmnopqrstuvwxyz 
OPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!) abcdefghijkimnopqrstuvwxyz 
PQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!) abcdefghijklmnopqrstuvwxyz A 
QRSTUVWXYZ 0123456789 #$%7&(+)-/*\<@>(1) abcdefghijklmnopqrstuvwxyz AB 
RSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!) abcdefghijklmnopqratuvwxyz ABC 
STUVWXYZ 0123456789 #$%76(+)-/*\<@>(!)} abcdefghijklmnopqrstuvwxyz ABCD 
TUVWXYZ 0123456789 #$%76(+)-/*\<@>(!) abcdefghijkimnopqrstuvwxyz ABCDE 
UVWXYZ 0123456789 €$%?6(+)-/*\<@>(!)} abcdefghijklmnopqrstuvwxyz ABCDEF 
VWXYZ 0123456789 #$%7&(+)-/*\<@>(!) abcdefghijklimnopqrstuvwxyz ABCDEFG 
WXYZ 0123456789 #$%76(+)-/*\<@>(!) abcdefghijklmnopqrstuvwxyz ABCDEFGH 
XYZ 0123456789 #$%?6(+)-/*\<@>(!)} abcdefghijklmnopqrstuvwxyz ABCDEFGHI 
YZ 0123456789 #$%?6(+)-/*\<@>(!) abcdefghijklmnopgqrstuvwxyz ABCDEFGHIJ 
Z 02123456789 #$%?&(+)-/*\<@>(!}) abcdefghijklmnopqrstuvwxyz ABCDEFGHIJK 
0123456789 #$%?&(+)-/*\<@>(!) abcdefghijkimnopqrstuvwxyz ABCDEFGHIJKL 
0123456789 #S$82&(+)-/*\<@>{!} abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLM 
0123456789 &S%?&(4+)-/*\<@>(!) abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMN 
123456789 #$%2&(+)-/*\<@>(!) abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNO 
23456789 #$%?&(+)-/*\<@>(!) abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOP 
3456789 #$%276(+)-/*\<@>(!) abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQ 
456789 #$%2&(+)-/*\<@>(!) abcdefghijkimnopqrstuvwxyz ABCDEFGHIJKLMNOPQR 
56789 #$%?6(+)-/*\<@>(!) abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRS 
6789 #$82&(+)-/*\<@>(!) abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRST 
789 #$%?6(+)-/*\<@>(!) abcdefghijkimnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTU 
89 8S87&(+)-/*\<@>(!) abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUV 
9 8$%7h(4+)-/*\<@>(!) abcdefghijkimnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVW 
9$82G(+)-/*\<@>(!} abcdefghijkimnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWX 
#$B7&(+)-/*\<@>(!) abcdefghijklmnopgqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXY 
$826 (+)-/*\<@>(!}) abcdefghijkimnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ 
$7&(+)-/*\<@>(!) abcdefghijkimnopqrstuvwxyz ABCDEFGHIJKLMNOPORSTUVWXYZ 
THIS IS THE LAST LINE 


Figure A-1: 5256 Printer Test Output 
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1 IDEAcomm 5251 - 5224/5225 Printer Diagnostic 1 
2 Version 1.00 2 
3 3 
4 ITITITILITITILTIIIIITIIIIIIITIIIIIIIIIIIIIIIINIIIIIIIIIIIIIIIFIIIIIIIIIIIIII 4 
5 I! Il 5 
6 til Iit DDDDDD EEEEEEE AA Il 6 
7 #&It I D D E A A II 7 
8 II I D D E A A II 8 
9 II I D D EEEEE AAAAAAAA II 9 
10 II I D D E A A II 10 
11 é$QIf I D D E A A It 11 
12 II Iti DDDDDD EEEEEEE A A It 12 
13 II II 13 
14 TEEIQLITIQLLIIIIAFIFIIIIIITILIIIIIIIFILITIITXIIIITITIITIIIIIFIIIIIFITIVIIIIIAIII 14 
15 15S 
16 The following block of text is printed at 10 cpi and 6 lpi. 16 
17 17 


18 ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!}) abcdefghijkinn 18 
19 BCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!) abcdefghijkimno 19 
20 CDEFGHIJKLMNOPOQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!)} abcdefghijkimnop 20 
21 DEFGHIJKLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!} abcdefghijklmnopq 21 
22 EFGHIJKLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!) abcdefghijklmnopgr 22 
23 FGHIJKLMNOPQRSTUVWXYZ 0123456789 #$%?6(+)-/*\<@>(1) abcdefghijkimnopqrs 23 
24 GHIJKLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!) abcdefghijklmnopqrst 24 
25 HIJKLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!} abcdefghijklmnopqrstu 25 
26 IJKLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>{!}) abcdefghijklmnopqrstuv 26 
27 JKLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!} abcdefghijklmnopqrstuvw 27 
28 KLMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/8#\<@>(!)} abcdefghijklmnopqrstuvwx 28 
29 LMNOPQRSTUVWXYZ 0123456789 #$%?&(+)-/*\<@>(!) abcdefghijklmnopgqrstuvwxy 29 


30 30 
31 The following block of text is printed at 12 cpi and 8 lpi. 31 
32 Line numbers should be printed at the end of the line. 32 
33 

34 EE SO UWINE. 0123456789 

35 BCDEFGHLIKLMNO 0123456789 

36 CDEFGHLJKLMNO Z 0123456789 

37 DEFGHLJIKLMNO 012 789 2 

38 EFGHIJKLMNO 56789 2 

39 FGHLJKLMNO. Z 012345678 2&( 

40 GHIJKLMNO 0123456789 2& (+) 

41 HLJKLMNO Z 0123456789 2&(+ 

42 LJKLMNO % 0123456789 { ?&( \ : 

vi JIKLMNO Z 0123456789 #$%7&(+)-/*\<@>(!) 

45 The following block of text is printed at 15 cpi and 6 lpi. 45 
46 Line numbers should be printed at the end of the line. 46 
at 47 


48 ABCLERCHIIKIMORRSIUMXYZ 0123456789 #687&(+)-/M (1) abodefghijkimmopgestuweyz =ABCERCHIKIMOPORSIUWYZ, 48 
A9 BOOFFCHIIKIMCRGRSTUWKYZ 0123456789 #9%76(+)-/*\c>{!)  abodefchijkbmaprshawyz ABDERHDUKIMORRSTIUWKYZ 49 
5O COFFCHIIKIMNORRSIUWKYZ 40123456789 #9%76(+)-/Ac>{!)  abatefuhijkinrongestumeyz ABCERHDKIMORSIUWKYZ 50 
5) DERHIKIMORFSIUMAYZ 01273456789 #ORPE(+)-/M\@>(1) abodefghijkimoppstuweyz ABCERHUKMORSIUNKYZ 0 51 
52 ERCHIKIMORSTIUWYZ 0123456789 FSR7&(+)-/\<>(!) abodefshijklmgestuweyz ABCERCHIKIMCRGRSTIUMKYZ «01 £2 
53 KHDIKIMORGRSTUWKYZ 0123456789 #987&(+)-/*\ (1) abodefhijkimogstmeyz ABLERHUKIMOPSIUMYZ 012 53 
54 CHLKIMORGRSIUWYZ, 0123456789 #S87&(+)-/*\>(!)  abodefghijkimropstuweyz ABCERCHIKIMOPQRSIUWKYZ 0123 5A 
55 HUKIMNORGRSTUWKYZ, 0123456789 #5476(+)-/*\ (1) ahodefohijkimopgestiawyz ABCERCHDKIMORRSTIWYZ 0124 55 
56 LIKIMURGSIUMKYZ 0123456789 #S87&(+)-/M (1) abadefthijidmapgstimeyz ARIFRHDKIMORSSIUWKYZ 0125 56 
57 JKIMORGRSIUMIKYZ, 0123456789 #5876 (+)-/M\>(!) abalefchijkimaepstieyz ABDERHIUKIMORGSIUWKYZ 0123456 57 
5B KUIMORFSIUWNYZ 0173456789 #876 (+)-/*\ >!) abodefuhijdmrogeshaeyz ABCERHITKIMORGRSIUYZ «0174567 5B 
59 TMNCRGRSTUMRKYZ 0123456789 #SE?E(+)-/*\c>(!) abodefuhijkimrprstuweyz ABCLERGHIUMIMORIRSIUNKYZ 012345678 59 
60 THIS IS THE LAST LINE 60 


Figure A-2: 5224/5225 Printer Test Output 
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If you are using a $224/5225 printer with graphics 
capability, a printer graphics test is run. The 
following message and graphics pattern should be 
printed. 


Note that if your 5224/5225 is not set up for 
graphics capability, the following message is printed 
with the line of stars, but the graphic box and the 
word IDEA are not printed. 


Printer Graphics Test 


The following graphics pattern should appear as a box 
with looped corners containing the IDEA logo in the 
center. This will only be printed if you have the printer 
graphics commands set up correctly. 


KEKEKKREKREKRKKSEKSESSREEKEKKEKKRSKEKRHEKRERERSEKEKEKKREREREEREESE 


IDEA 


Figure A-3: Graphics Test Output 
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1 1 
2 IDEAcomm 5251 - 5219 Printer Diagnostics 2 
3 Version 1.00 3 
1 2 3 4 5 6 7 8 
123456789012345678901234567890123 4567890123456 789012345678901 2345678901234567890 
LEFT MARGIN RIGHT MARGIN 
IIIIIIIIIIIIQIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIXFIIIIII 9 
10 II II 10 
11 I1 III DDDDDD EEEEEEE AA Ir 11 
12 II I D D E A A Iz 12 
13 II I D D E A A II 13 
14 II I D D EEEEE AAAAAAAA II 14 
iS ii I D 2 Ez A A II 15 
16 IJ I D D E A A II 16 
17 II II DDDDDD EEEEEEE A A Ir 17 
18 II II 18 


19 ITITIIIIIFIIFIIIIIIIIIIIIIIIIIIFIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII 19 


21-This printer diagnostic is used to verify operation of the PC-21 
22-printer being used to emulate a 5219 printer. This diagnostic can-22 
23-be invoked from the printer control panel by selecting the Test-23 
24-PC Printer option. This diagnostic can also be used to verify-24 
25-that the printer command sequences have been configured properly.-25 
26-This paragraph is a test of the Set Justify Mode. Every line in-26 
27-this paragraph should be justified between both margins.-27 


29-This is the left column. This is the right column. -29 
30-This column should be This column should be justified-30 
3l-justified. This is a test This is a test of the justify-31 
32-of the justify text field text field command. This is the-32 


33-command. This is the end. jast line of the right column.-33 


35 THIS LINE IS HIGHLIGHTED 35 
37 THIS LINE IS UNDERLINED 37 


39 superscript normal 1 superscript normal 


subscript norma subscript 39 


**41 The “**" on this line should be to the left of the left margin. 41 


43 ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 @#$%&-*(+)=? abcdefghijk 43 
44 BCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 @#$%&-*(+)=? abcdefghijkl 44 
45 CDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 @#$%&-*(+)=? abcdefghijklm 45 
46 DEFGHIJKLMNOPQRSTUVWXYZ2 0123456789 @#$%&-*(+)=? abcdefghijkimn 46 
47 EFGHIJKLMNOPQRSTUVWXYZ 0123456789 @#$%&-*(+)=? abcdefghijklmno 47 
48 FGHIJKLMNOPQRSTUVWXYZ 0123456789 @#$%&-*(+)=? abcdefghijkimnop 48 
49 GHIJKLMNOPQRSTUVWXYZ 0123456789 @€$%&-*(+)=? abcdefghijklmnopq 49 
50 HIJKLMNOPQRSTUVWXYZ 0123456789 @#$%&-*(+)=? abcdefghijklmnopqr 50 
51 IJKLMNOPQRSTUVWXYZ 0123456789 @#S%&-*(+)=? abcdefghijkimnopqrs 51 
52 JKLMNOPQRSTUVWXYZ 0123456789 @#$%&-*(+)=? abcdefghijklmnopqrst 52 
53 KUMNOPQRSTUVWXYZ 0123456789 @#$%6-*(+)=? abcdefghijklmnopqrstu 53 
54 LMNOPORSTUVWXYZ 0123456789 @#S%s-*(+)=? abcdefghijklmnopqrstuv 54 
55 MNOPORSTUVWXYZ 0123456789 6#$%&-*(+)=? abcdefghijklmnopqrstuvw 55 
56 NOPQRSTUVWXYZ 0123456789 @#$%&-*(+)=? abcdefghijkimnopgrstuvwx 56 
57 OPQRSTUVWXYZ 0123456789 &@#$%&-*(+)=? abcdefghijklmnopqrstuvwxy 57 
58 PQRSTUVWXYZ 0123456789 @#S$%&-*(+)=? abcdefghijklmnopqrstuvwxyz 58 
59 QRSTUVWXYZ 0123456789 6#$%6-*(+)=? abcdefghijklmnopqrstuvwxyz 59 
60 THIS IS THE LAST LINE 60 


Figure A-4: 5219 Printer Test Output 
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Printer Output from Host 


If there is no printer output from the host, you can 
run the System 3X Test Request and use the results 
to troubleshoot the problem. To run this test, do 
the following: 


1. From the Logon screen, press F2 and the 
BACKSPACE key together. (On the Enhanced 


keyboard, use Shift—Scroll Lock.) The Option 
Menu is displayed. 


2. From the Option Menu, choose the 
Workstation Printer Verification option. The 
Workstation Printer Verification Menu is 
displayed. 


3. On the Workstation Printer Verification Menu, 
enter the appropriate printer identification that 
corresponds to your printer address. If an 
error message is displayed it may mean one of 
the following conditions: 


—— printer is offline. 
—— the configured printer is not attached. 
— an incorrect station address was chosen. 


4 If no error occurred in step 3, a menu is 
displayed with several test choices you can 
select. Select the Print Test 1 Time option. 
When the test has finished, the PC printer 
should print the System 3X diagnostic code. 


5. To back out of the menus, press the C key 
until you reach the original menu displayed 
when you began the test. 
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TWINDIAG Diagnostic 
Program 


In order to run the TWINAX Diagnostic Program, 
set the termination switch to the TERM position 
(see Figure 4-2 of the hardware manual). Make 
sure that you have already run the INSTALL 
program. Note that the following files are required: 


TWINDIAG.EXE 

TWINAXn.UCM 

(TWINAX4.UCM for upgrading the 4 LU version) 
Z80MEM.TSK 


Note 


The older program TWINDIAG.COM, if it 
exists in the same directory, must be 
deleted or renamed before you enter the 
command TWINDIAG. 


Type the following at the DOS prompt: 
TWINDIAG <Enter> 


You see the following menu: 


TWINDIAG Version x.x Copyright (C)198x IDEAssociates, Inc. 
What option would you like? _2 


1. General Diagnostics 


3. Memory Burn In Test 


Use Up/Down arrows,Press ENTER to select or ESC to Exit 


Figure A-5: TWINDIAG Main Menu 
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TWINDIAG General Diagnostics 


This is discussed in the hardware manual. 


Printer Diagnostics Using TWINDIAG 


If your printer output does not match the source 
document, you can run a trace diagnostics test from 
the main TWINDIAG menu to help trace the 
problem. 


When you select this option, you see the following 
screen: 


TWINDIAG Version x.x Copyright (C) 198x IDEAssociates, Inc. 
What option would you like? ] 


1. System 3X printer dump 
2. PC printer command dump 


Use Up/Down arrows, Press <ENTER> to Select or ESC to Exit 


Figure A-6: Printer Menu of TWINDIAG 


The System 3X dump sends printer data from the 
host system to the port or file that you name. The 
program asks you to select an emulated printer to 
trace, and to name a port or file. See your host 
manual or host administrator for an analysis of the 
information. 


The PC printer dump sends data from your PC to 
the port or file that you name. The program asks 
you to select a PC printer to trace, and to name a 
port or file. This data includes both printer 
commands and data to be printed, in ASCII code. 
The printer commands are listed in Section III of 
the Technical Reference Guide. Abbreviated forms 
are on page S-7. 


To request a print from the host, first make 
TWINAX resident, then hot key to DOS. Invoke 
TWINDIAG and select PRINTER DUMP, then the 
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type of dump you want with printer type, port, and 
filename. Then hot key back to TWINAX, issue 
the appropriate host print command, and hot key 
back to TWINDIAG to begin processing. 


This data which is sent from the host should agree 
with the printed output. For example, if the 
printout is 8 lines per inch, the trace printout 
should display an 8 lines per inch character code 
preceding the data. One such code is SSLD or 2B 
D2 04 15 OC. 


Memory Test from TWINDIAG 


This is discussed in the hardware manual. 
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TWINDIAG Error Messages 


TWINDIAG-005 CONFIGURATION ERROR -- 
UNABLE TO CONTINUE. 
There has been an error during an attempt to load 
data from TWINAXn.UCM. 


TWINDIAG-007 UNABLE TO LOAD 
CONFIGURATION FILE -- DIAGNOSTICS 
ABORTED 

There has been an error during an attempt to load 
data from TWINAXn.UCM. 


TWINDIAG-019 TRANSMITTER TIME OUT -- 
TRANSMITTER FAILURE -- ABORTED. 
The simple transmitter test has failed. 


TWINDIAG-025 INVALID PARAMETER 
SPECIFIED. 

An invalid parameter was specified on the 
command line. 


TWINDIAG-034 TWINAX NOT RESIDENT, 
UNABLE TO PERFORM PRINTER DUMP 
To perform the printer dump, be sure that 
TWINAX is loaded (type TWINAX and press 
Enter), and resident (press Shift-Shift). Then 
invoke TWINDIAG. 


TWINDIAG-035 NO PRINTERS 
CONFIGURED, PRINTER DUMP ABORTED 
You must have at least one printer configured with 
IDEACFIG or INSTALL. 


TWINDIAG-036 DUPLICATE CONFIGURA- 
TION FILES TWINAX4.UCM AND 
TWINAX7.UCM FOUND. ONE OF THE 
CONFIGURATION FILES MUST BE DELETED 
Copy to another directory and then delete one file. 
TWINAX4.UCM runs with the 4 LU (16K board) 
product IDEAcomm 5251. TWINAX7.UCM runs 
with the 7 LU (32K board) product IDEAcomm 
5251/Plus. 
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TWINAX Program Messages 


TWIN-001 EXITED TWINAX 
Control has returned to DOS. 


TWIN-002 FILE I/O ERROR, ACCESS DENIED 
The path is not typed correctly. 


TWIN-003 INSUFFICIENT FILE HANDLE 
TWINAX could not locate specified files. 


TWIN-004 ERROR ACCESSING 
CONFIGURATION FILE 

The configuration file TWINAXn.UCM is missing 
or corrupted. Be sure that you have only one of 
the files TWINAX7.UCM or TWINAX4.UCM. If 
necessary, recopy the file from the original diskette. 


TWIN-005 NO PRINTER ASSIGNED 
No printer is defined with IDEACFIG. 


TWIN-006 NO DISPLAY CONFIGURED 

You did not specify a terminal in the configuration. 
You asked for an illegal host session number, or a 

host session that is not configured as a display, or 

you typed illegal characters. 


TWIN-007 INVALID PATHNAME OR 
GREATER THAN 63 CHARACTERS 

The subdirectory does not exist or the path is 
incorrect. 


TWIN-008 PRINTER TEST FILE NOT FOUND 
Since this diagnostic accesses disk files on the 
current default drive of the PC or PS/2, the 
following disk files must be present: 


P5256.TST 
P522X.TST (for 4214 and 5224/5225 emulation) 
P5219.TST 


TWIN-009 MEMORY TEST FAILURE. CHECK 
MEMORY ADDRESS CONFIGURATION. 
The screen buffer (RAM memory) test executed on 
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power up and failed. Verify that the board setting 
for PC memory address or IBM configuration 
program for the micro channel card matches the 
memory address in IDEACFIG. 


TWIN-010 NO SESSIONS CONFIGURED -- 
TWINAX LOAD ABORTED 

No host sessions are configured. Use IDEACFIG 
to configure host sessions for display or printer 
devices. 


TWIN-011 INCOMPATIBLE DISPLAY TYPE 
INSTALLED 

Your system has a display adapter not supported by 
IDEA, usually a 40 column adapter (for example, 
the PCjr adapter). 


TWIN-012 PRINTER I/O ERROR 

You issued a local PrintScreen to a nonexistent 
printer, or one that was out of paper or otherwise 
inoperative. 


TWIN-013 I/O ERROR ACCESSING 
MICROCODE FILE 
The IDEAcomm card microcode has been stopped. 


TWIN-014 USER DEFINED STRING EMPTY 
A necessary printer configuration string has been 
omitted. 


TWIN-015 TWINAX RESIDENT--USE HOT 
KEY TOGGLE TO RE-ENTER EMULATION 
You have entered a QUIT command while 
TWINAX is resident. To exit TWINAX when 
TWINAX is resident, press both Shift keys. 


TWIN-016 ERROR CONFIGURING 
PARALLEL PORT LPT1 PORT NOT 
CONFIGURED 

Port LPT1 was not available. If necessary, use 
IDEACFIG or INSTALL to choose another port on 
your system. 


TWIN-017 ERROR CONFIGURING PARALLEL 
PORT LPT2 PORT NOT CONFIGURED 
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Port LPT2 was not available. If necessary, use 
IDEACFIG or INSTALL to choose another port on 
your system. 


TWIN-018 ERROR CONFIGURING PARALLEL 
PORT LPT3 PORT NOT CONFIGURED 

Port LPT3 was not available. If necessary, use 
IDEACFIG or INSTALL to choose another port. 


TWIN 019 ERROR CONFIGURING SERIAL 
PORT COM1 PORT NOT CONFIGURED 

Port COM1 was not available. If necessary, use 
IDEACFIG or INSTALL to choose another port on 
your system. 


TWIN 020 ERROR CONFIGURING SERIAL 
PORT COM2 PORT NOT CONFIGURED 

Port COM2 was not available. If necessary, use 
IDEACFIG or INSTALL to choose another port on 
your system. 


TWIN-022 PS/2 CONFIGURATION ERROR 
The IDEAcomm micro channel card is either not 
installed or could not be found. 


TWIN-023 PS/2 INSTALLATION ERROR 
The configuration could not be determined from 
values read from the card. The ADF file may be 
corrupt, or the problem may be card related. Call 
IDEA Technical Support for assistance. 


TWIN-026 ADAPTER ALREADY IN USE 
You cannot run TWINAX while the 5251/Plus 
board is being used for AS/400 file transfer. 


IDEACFIG Messages 


DUPLICATE CONFIGURATION FILES 
TWINAX4.UCM AND TWINAX7.UCM FOUND. 
ONE MUST BE DELETED. 


You have configuration files for both the 4 LU and 
the 7 LU configuration in the same directory. 
Delete or move the one you do not need and 
restart IDEACFIG. 
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ASCII Chart 


Use these codes if you must change the 
ASCII/EBCDIC table in the IDEACFIG file. 


A Hex Non-Displ haracter 


01 soh (CTRL-A) 
02 stx (Ctrl-B) 

03 etx (Ctrl-C) 

04 eot (Ctrl D) 

0S enq (Ctrl E) 

06 ack (Ctrl-F) 

07 bell (Ctrl-G) 

08 bs (Ctrl—-H) 

09 horizontal tab (Ctri—I) 
0A line feed (Ctrl—J) 
0B vertical tab (Ctrl—K) 
0C form feed(Ctrl—L) 
0D carriage return (CtrI—-M) 
OE so (Ctrl-N) 

OF si (Ctrl—-O) 

10 dle (Ctrl P) 

11 dc1 (Ctrl-Q) 

12 dc2 (Ctrl-R) 

13 dc3 (Ctri—S) 

14 dc4 (Ctrl T) 

15 nak(Ctrl U) 

16 syn (Ctrl-V) 

17 etb (Ctrl W) 

18 can (Ctrl—X) 

19 em (Ctrl-Y) 

1A sub (Ctrl-Z) 

1B esc (Ctri-[) 

1C fs (Ctrl-\) 

1D gs (Ctrl—-]) 

1E rs (Ctrl—6) 

iF us (Ctrl—) 
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Appendix B: 

Keyboard and 
Terminal Defaults 
ene 


Overview 


This appendix describes keyboard functions and 
display attributes of the emulated terminal. 


Emulated Keys on the IBM 
Keyboards 


TWINAX includes emulation of the host keyboard 
on four different microcomputer keyboards: the 
IBM Enhanced keyboard, the IBM AT, the 
keyboard for the IBM PC, XT, and Portable, and a 
generic 3180 keyboard. 


In addition, for the Enhanced, AT, and PC/XT, 
you may choose the IDEA/IBM layout, which is 
similar to the layout of a 5250 keyboard, or a 
layout that is closer to the normal PC keyboard. 
You can select the layout you want to use from the 
IDEACFIG Keyboard Options menu. 


Special Modes 
Shift Keys: When the Shift key is pressed: 


@ The special characters on the key tops of the 
numeric and symbol keys are entered. 


@ The alphabetic characters are entered as 
uppercase letters. 


@ The function control keys perform the function 
shown. on the top half of the emulated keys. 
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Shift Lock Key: When the emulated Shift Lock 
Key (Ctrl key on the PC keyboard) is pressed: 


The special characters on the Key tops of the 
numeric and symbol keys are entered. 


The alphabetic characters are entered as 
uppercase letters. 


The function coniroi keys perform the function 
shown on the bottom half of the emulated Keys. 


The keyboard locks in shifted mode until the 
Shift key is pressed and released. 


Note 


The Shift Lock function operates differently 
than the Caps Lock or the Num Lock 
functions found on the IBM Personal 
Computer. 


Free key mode: when used in this section means 
that your PC is not varied on. 


The following tables describe the function of the 
keys on the PC keyboard when you are in 
emulation. 


B-2 Keyboard and Terminal Defaults 


Attn 


Change Host Session 


Clear 


en 

Left, Right 
Up, Down 
Back Tab 
Tab 


Dup 
Enter/Rec Adv 
Erase Input 
Error Reset 
Field + 

Field - 

Field Exit 
Help 

Home 

Ins 

New Line 
Print 

PrtSc (Local Print) 


Roll Up 


Roll Down 


Sys Req 

Test Req 

= 

! or cent sign 
! or \ 

> or< 


{ or } 


PC/XT/AT Key 
Fl 

Ctrl-L 
Shift-Cmd-Bksp 


Scroll Lock 
Caps Lock 
Shifted F4 


Shift-PrtSc 
Shifted F7 


Shifted F8 
Shifted Fl 


Not Used 
Shift-6 


1 shifted 


CMD 1 through CMD9 F2-1 through 9 


CMD10 through 12 
CMD13 through 21 
CMD7272 through 24 


F2-0, -, = 


F2~-shift-1 through 9 


F2—),_.* 


Table B-1: Emulated Keys: IBM 5250/3180 Layout 


Enhanced Key 
Print Screen 
Ctrl-L 
Shift-Scroll Lock 


Cc 
Arrow Keypad 
Arrow Keypad 

Back Tab 

Tab 

Delete 

Num. Lock 

Num. Enter, Rt Ctrl 
Shift-Home 

Left Alt 

Num. + 

Num. - 

Enter 

Page Down 

Home 

Insert 

Right Alt 

Page Up 

Shift-PgUp 

Shift-f on arrow 


Shift-] on arrow 
keypad 
Shift-Print Screen 
Scroll Lock 


Shift-6 


1 shifted 

F1 through F9 
F10 through F12 
Shifted F1 - F9 
Shifted F10 — F12 
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IBM Ke 
Attn 


Change Host Session 

Clear 

Cmd Menu 

Cursor: Left, Right 
Up, Down 
Back Tab 
Tab 


Dup 
Enter/Rec Adv 
Erase Input 
Error Reset 
Field + 

Field - 

Field Exit 


Help 

Home 

Ins 

New Line 

Print 

PrtSc (Local Print) 
Roll Up 

Roll Down 

Sys Req 


Test Req 


cent sign 


CMD1-CMD10 
CMD11, CMD12 
CMD13-CMD20 
CMD21-CMD24 


PC/XT/AT Ke 
Ctrl on PC; 
Shift-Sys Req on AT 
Ctrl-L 
Shift-Scroll Lock 
Ctrl-Esc 
Num.4,6 

Num. 8,2 

Back Tab 

Tab 

Num. 


Num.- 
Alt-Enter on PC; 
‘Ctrl on AT 

Esc 

Num.7 

‘Num.0 (ins) 
Shift-Enter 
Alt-PrtSc 
Shift-PrtSc 
Num.3 

Num.9 
Shift-Ctrl on PC: 
Sys Req on AT 
Not Used 


Shift-6 


Shift- 


F1-F10 

Shifted F1, F2 
Shifted F3-F10 
Alt-F1 - Alt-F4 
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Table B-1: Emulated Keys: PC Style Layout 


Enhanced Ke 
Esc 


Ctrl-L 

Pause, Shift-Pause 
Ctrl-Esc 

Arrw Kypd, Num.4, 6 
Arrw Kypd, Num.8,2 | 
BackTab (Shift-Tab) 
Tab, Shift-Num.+ 
Num. ., Delete 
Shift-Insert 
Num.Enter, Right Ctr 
Shift-End 

Left Ctrl 

Num. + 

Num. - 

Enter 


Shift-Scroll Lock 
Num.7 

Insert, Num.0 
Shift-Enter 
Shift-Print Screen 
Print Screen 
Num.3, Shift PgUp 
Num.9, Shift PgDn 
Alt-Print Screen 


Alt-—Pause 


Shift- ] 
Shift-\ 
F1-F10 

F11, F12 
Shifted F1-F8 
Shifted F9-F12 


Table B-2: Emulated Key Functions 
IBM 5250 Key Function 


Attn 


Notifies host of sign—on change. 


Change Host | Changes Host Session screen. Allows you 
to view a different emulated host screen 
or the Printer Control Panel if a printer is 


configured. 


Session 


Clear 
Cmd 


Clears the screen. 


System dependent. With most systems, 
directs the system to disregard the normal 
function shown on the top row key and to 
perform the function assigned to the key in 
the system program. 


Cmd Menu 


Cursor: 


Displays the Command Menu. 


Arrow Keys cause the cursor to move in 
the direction indicated by the arrow on the 
key top. 


New Line | Moves the cursor forward (right) to the 
first character position of the field following 


the field it is in. 


Moves the cursor back (left) to the first 
character position of the field it is in. If 
the cursor is in the first position of a field, 
it moves back to the first position of the 
preceding input field. 


Backspace 


Field Tab key moves the cursor forward 
(right) to the first character position of the 
field following the field it is in. 


Delete, when pressed with an Upper-shift 
key, deletes the characters where the 
cursor is located. 
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Table B-2: Emulated Key Functions (Continued) 


System Key | Function 


Duplicate requests that the system program 
duplicate the information from the same 
field in the previous record. 


t Enter/Record Advance indicates that the 
entered data is ready to be sent to the host 
system. 


Erase Input Erase Input when pressed with a Shift key 
erases data entered in all input fields. The 
cursor moves to the home position on the 
screen. In free key mode, this key erases 
everything on the screen and moves the 


cursor to the first input position on line 1. 


Error Reset unlocks the keyboard when it is 
locked because of an error condition. It 
can also be used to reset the help, insert, 
system request, and command modes. 


Error Reset 


Field + Field + operates as a field exit key in all 


fields. 


Field — is system dependent. With most 
systems it operates the same as Field and 
Field Exit except that it is allowed in signed 
numeric and numeric fields only. 


Field — 


Field Exit Field Exit is used to exit input fields that 
are specified by a program as right adjusted 


or field exit required fields. 


Help Help displays a description of the current 
error condition. Press the Error Reset key 
to reset the help message and the error 
condition, restore the display screen, and 


unlock the keyboard. 


Home moves the cursor to the system desig- 
nated home position when the display 
screen is under system program control. 
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Table B-2: Emulated Key Functions (Continued) 
System Ke Function 


In Free Key mode, Home returns the 
cursor to the first input position on line 1. 


When supported by the host system 
program, this key is pressed to display a 
previous record if the cursor is in the 
home position. 


Note: In some screens, if this key is 
pressed twice you will lose data. 


Insert sets the keyboard to insert mode so 
that data will be entered at the cursor 
position and all data to the right of the 
cursor will move right. To exit insert 
mode, press the Error Reset key 
combination. 


Local Print See Print Screen 


New Line Moves the cursor to the first input position 


of the first field of a new line. 


Print 


Print sends a print request to the host 
system. 


Print Screen | Sends a copy of the screen to your local 


PC printer. 


Roll keys Roll keys when pressed with the Shift key 
move information up or down. The system 
program controls the use of these keys for 


each job. 


System Request key is system dependent. 
With most systems, it can be used to 
initiate sign-on, select an alternate job, 
temporarily stop the present display activity 
and allow selection of a new activity. 


Test Req Test Request is system dependent. 
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Attribute Appearance for 
5250 Display Station and 
Monochrome Personal 
Computer 


In the following chart: 


@ Normal means a lighter character on a darker 
field. 


@ Reverse means a darker character on a lighter 
field. 


@ Light means high intensity. 


@ Null refers to any keystroke or non—keystroke 
that displays as a blank or space. 
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IBM 
Meaning 


NORMAL 
REVERSE 


HIGH 
INTENSITY, 
NORMAL 


REVERSE 
HIGH 
INTENSITY 


UNDERSCORE 
NORMAL 


UNDERSCORE 
REVERSE 


UNDERSCORE 
HIGH 
INTENSITY, 
NORMAL 


NO DISPLAY 


BLINK, 
NORMAL 


BLINK, 
REVERSE 


BLINK, 
HIGH 
INTENSITY, 
NORMAL 


BLINK, 
HIGH 
INTENSITY, 
REVERSE 


BLINK, 
UNDERSCORE 
NORMAL 


BLINK, 
UNDERSCORE 
REVERSE 


Monochrome PC 
5251 Card 


Green characters 
on black 


Black characters 
on green 


Light green characters 


on black 


Black characters 
on green 


Green on black with 
green underscore 


Black on green 


Light green on black 
with light green 
underscore 


No display 


Blinking green 
on black 


Blinking black 

on green 

Blinking light green 
on black 


Blinking black 
on green 


Blinking green on 
black with blinking 
green underscore 


Blinking black 
on green with 
green underscore 


Table B-3: Monochrome Attributes 


Monochrome PC 
with 5251 Card 
& 5251 D Card 


Green characters 
on black 


Black characters 
on green 


Light green charac- 
ters on black 


Black characters 
on green 


Green on black with 
green underscore 


Black on green with 
black underscore 


Light green on black 
with light green 
underscore 


No display 


Blinking green 
on black 


Blinking black 
on green 


Blinking light green 
on black 


Blinking black 
on green 


Blinking green on 
black with blinking 
light green 
underscore 


Blinking black on 
green with blinking 
light green 
underscore 
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Table B-3: Monochrome Attributes 


HEX 
Code 


2E 


2F 
30 


31 


32 


33 


34 


35 


36 


37 


IBM 
Meaning 


BLINK, 
UNDERSCORE, 
HIGH 
INTENSITY, 
NORMAL 


NO DISPLAY 


COLUMN 
SEPARATORS, 
NORMAL 


COLUMN 
SEPARATORS, 
REVERSE 


COLUMN 
SEPARATORS, 
HIGH 
INTENSITY 
NORMAL 


COLUMN 
SEPARATOR 
HIGH 
INTENSITY, 
REVERSE 


COLUMN 
SEPARATOR, 
UNDERSCORE, 
NORMAL 


COLUMN 
SEPARATORS, 
UNDERSCORE 
REVERSE 


COLUMN 
SEPARATOR 
UNDERSCORE 
HIGH INTENSITY 
NORMAL 


COLUMN 
SEPARATORS 


Monochrome PC 
§251 Card 


Blinking light green 


on black with blinking 


green underscore 


No display 
Green on black with 


green rectangular bars 


in null positions 


Black on green with 


black rectangular bars 


in null positions 


Light green on black 
with light green 
rectangular bars in 
null positions 


Black on green with 


black rectangular bars 


in null positions 


Green on black with 


green rectangular bars 


in null positions and 
green underscore 


Black on green with 


black rectangular bars 


in null positions 


Light green on black 
with light green bars 
in null positions and 


light green underscore 


Green rectangular bars 


on black. No other 


characters displayed. 


B-10 Keyboard and Terminal Defaults 


Monochrome PC 
with 5251 Card 
and 5251 D Card 


Blinking light green 
on black, blinking 
light green 
underscore 


No display 


Green characters 
on black with green 
column separators 


Black characters on 
green with black 
column separators 


Light green 
characters 

on black with light 
green column 
separators 


Black characters on 
green with black 
column separators 


Green characters on 
black with green 
column separators, 
green underscore 


Black characters on 
green with black 
column black 
underscore 


Light green charac-— 
ters on black with 
light green column 
separators, light 
green underscore 


Green column 
separators on 
black. No other 
characters displayed. 


COLUMN 
SEPARATORS, 
BLINK, 
NORMAL 


COLUMN 
SEPARATORS, 
BLINK, 
REVERSE 


COLUMN 
SEPARATORS, 
BLINK, 

HIGH INTENSITY 
NORMAL 


COLUMN 
SEPARATORS, 
BLINK, 

HIGH 
INTENSITY, 
REVERSE 


COLUMN 
SEPARATORS, 
BLINK, 
UNDERSCORE, 
NORMAL 


COLUMN 
SEPARATORS, 
BLINK, 
UNDERSCORE, 
REVERSE 


COLUMN 
SEPARATORS, 
BLINK, 
UNDERSCORE, 
HIGH INTENSITY 
NORMAL 


COLUMN 
SEPARATORS 


Monochrome PC 
5251 Card 


Blinking green on 
black with blinking 
green rectangular bars 
in null positions 


Blinking black on 
green with blinking 
green rectangular bars 
in null positions 


Blinking green on 
black with blinking 
green rectangular bars 
in null positions 


Blinking black on 
green with blinking 
black rectangular bars 


‘in null positions 


Blinking green on 
black with blinking 
green rectangular bars 
in null positions and 
blinking green 
underscore 


Blinking black on 
green with blinking 
black rectangular bars 
in null positions 


Blinking green on 
black with blinking 
green rectangular bars 
in null positions 


Green rectangular bars 
on black. No other 
characters displayed. 


Table B-3: Monochrome Attributes 


Monochrome PC 
with 5251 Card 
and 5251 D Card 


Blinking green 
characters on black 
with blinking green 
column separators 


Blinking black 
characters on green 
with blinking black 
column separators 


Blinking light green 
characters on black 
with blinking light 
green column 
separators 


Blinking black 
characters on green 
with blinking black 
column separators 


Blinking green 
characters on black 
with blinking green 
column separators 
and blinking green 
underscore 


Blinking black 
characters on green 
with blinking green 
column separators 
and blinking black 
underscore 


Blinking light green 
characters on black 
with blinking light 
green column 
separators and 
blinking light 

green underscore 
Green column 
separators on 
black. No other 
characters displayed. 
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Attribute Appearance for 
5292 Display Station and 
Color Monitor Personal 
Computer 


In the following chart: 


Normal means a lighter character on a darker 
field. 


Reverse means a darker character on a lighter 
field. 


Light means high intensity. 


Null refers to any keystroke or non keystroke 
that displays as a blank or space. For example, 
if you used Hex Code color 24 (which includes 
an underscore for nulls) and typed the name 
JOHN SMITH, JOHN and SMITH would not 
be underscored, but the space that separates 
the two parts of the name would be 
underscored. Also, every blank in the 
remainder of the field would be underscored. 
Your screen would show: 


JOHN_SMITH 
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Table B-4: Color Attributes 


IBM 5292 
Display Station 


GREEN 


GREEN/REVERSE 
IMAGE 


WHITE 


WHITE/REVERSE 
IMAGE 


GREEN/UNDERSC 


GREEN/ 
UNDERSCORE/ 
REVERSE IMAGE 


WHITE/UNDERSC 


NON-DISPLAY 
RED 


RED/REVERSE 
IMAGE 


RED/BLINK 


RED/REVERSE 
IMAGE/BLINK 


RED/UNDERSC 


RED/UNDERSC/ 
REVERSE IMAGE 


RED/UNDERSC 
BLINK 


NON-DISPLAY 


TURQUOISE/COL. 
SEPARATORS 


IDEA 
Meaning 


Normal 


Reverse 


Normal 


Reverse 


Bright 
Normal 
Underscore 


Reverse 
Underscore 


Bright 
Normal 
Undersc 
Non-Disp 
Normal 
Reverse 


Blink, 
Normal 
Blink, 
Reverse 
Bright, 
Normal, 
Undersc 


Reverse, 
Underscore 


Bright, 
Blink, 
Normal, 
Underscore 


Non-Disp 


Normal, 
Column 
Separators 


IDEA Color Monitor 
Personal Computer 


Green characters on black 


Black characters on green 


White characters on black 


Black characters on white 


Light green on black 

with light green underscore 
characters for nulls 

Gray on green with gray 
underscore characters for 
nulls 

Light white on black 

with light white underscore 
characters for nulls 


Black on black 
Red characters on black 
Black characters on red 


Blinking red on black 
Blinking black on red 


Light red on black 
with light red underscore 
characters for nulls 


Gray on red with gray 
underscore characters for 
nulls 


Blinking light red on 
black with blinking 
light red underscore 
characters for nulls 


Black on black 


Cyan on black with cyan 
rectangular characters 
in null positions 
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Table B-4: Color Attributes (Continued) 


IBM 5292 


IDEA 


IDEA Color Monitor 


31 


32 


33 


34 


35 


36 


3A 
37 
38 
39 


3B 


3C 


3D 


3E 


3F 


Display Station 


TURQUOISE/COL. 
SEPARA TORS/ 
REVERSE IMAGE 


YELLOW/COL. 
SEPARATORS 


YELLOW/COL. 
SEPARATORS/ 
REVERSE IMAGE 


TURQUOISE/ 
UNDERSCORE 


TURQUOISE/ 
UNDERSCORE/ 
REVERSE IMAGE 


YELLW/UNDERSC 


BLUE 
NON-DISPLAY 
PINK 


PINK/REVERSE 
IMAGE 


BLUE/REVERSE 
IMAGE 


PINK/UNDERSC 


PINK/UNDERSC/ 


REVERSE IMAGE 


BLUE/UNDERSC 


NON-DISPLAY 


Meaning 


Reverse, 
Column 
Separators 
Bright, 
Normal 
Column 
Separators 
Reverse, 
Column 
Separators 
Bright, 
Normal 
Underscore 


Reverse, 
Underscore 


Bright, 
Normal 
Underscore 


Normal 
Non-Display 
Normal 


Reverse 
Reverse 


Bright, 
Normal, 
Underscore 


Normal, 
Reverse, 
Underscore 


Bright 
Normal 
Underscore 


Non-Display 
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Personal Computer 


Black on cyan with black 
rectangular characters 
in null positions 


Light yellow on black 
with light yellow 
rectangular characters 
in null positions 


Gray on brown with gray 
rectangular characters 
in null positions 


Light cyan on black with 
light cyan underscore 
characters in null positions 
Gray on cyan with gray 
underscore characters 

in null positions 


Light yellow on black with 
light yellow underscore 
characters in null positions 


Blue on black 
Non-Display 
Magenta on black 


Black on magenta 
Black on blue 


Light magenta on black 
with underscore characters 
in null positions 


Gray on magenta with gray 
underscore characters in 
null positions 


Light blue on black with 
light blue underscore 
characters in null positions 


Non-Display 


Appendix C: 
Using REVUP.EXE to 


Update Older Software 
eae 


REVUP.EXE enables you to transfer old printer 
configuration information, display information, and 
keyboard language information into a new revision 
of TWINAX. Each time a new revision of 
TWINAX is received, the new TWINAXn.UCM file 
and PRINTER.CMD file need to be reconfigured to 
include this information. REVUP.EXE saves you 
time by reading the old files and writing the 
appropriate printer, display, and keyboard language 
data into the new versions. 


The program is especially important for users 
changing to release 5.0 from a lower release, which 
uses different filenames. It is also recommended 
for users of non—U.S.A. keyboards who have 
changed their keyboard configuration, thereby 
altering the TWINAXn.UCM translation table. 


Running REVUP 


The program includes screen displays that tell you 
how to proceed. All you need do is: 


1. Rename your current TWINAX.UCM, 
TWINAX4.UCM, or TWINAX7.UCM to 
TWINAX.OLD . 


2. Rename PRINTER.DAT or PRINTER.CMD to 
PRINTER.OLD. 


3. If you are running emulation from a hard disk, 
make a new directory for the new 5251/Plus 
software. Copy files from all diskettes to this 
directory (or run INSTALL) 
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Transfer TWINAX.OLD and PRINTER.OLD to 
the new directory. (If you are running from 
diskette, transfer TWINAX.OLD and 
PRINTER.OLD to the diskette containing the 
new REVUP.) 


5. Type: 
REVUP <Enter> 
Example 


Reconfiguring TWINAXn.UCM to Transfer Old 
Configurations to Upgraded TWINAX 


Current Version: 4.0 TWINAX.UCM 


Desired Version: 5.x TWINAX7.UCM 


se 


Rename your current TWINAX.UCM to 
TWINAX.OLD. 


Rename your current PRINTER.DAT to 
PRINTER.OLD. 


If you are running emulation from a hard disk, 
create a new directory (V5.x) for the new 5251 
software and copy all diskettes to this directory. 


Copy TWINAX.OLD and PRINTER.OLD to 
the new software diskette or directory (V5.x). 


Type REVUP <Enter> 


The new TWINAX7.UCM (V5.x) now has the 
keyboard, printer, and display configuration 
that was in TWINAX.OLD. The new 
PRINTER.CMD has the printer tables that were 
in PRINTER.OLD. 
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Appendix D: 
The SEND File Editor 


Overview 


You can create a file, called a SEND file, that 
executes a sequence of commands within 
emulation. 


You can use this file with the SEND utility to send 
batch files that log on to the host or perform other 
repeated procedures. 


For example, you can use this file to log on to the 
host, enter DisplayWrite, and open a file for 
editing. You need enter only one command from 
DOS. 
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Running the Editor 


From DOS, enter: 
SNDEDIT <Enter> 


The screen displays all SEND files in the current 
directory and prompts you to select one for editing. 
To start a new file, for example, MINE.SND, 
enter: 


SNDEDIT MINE <Enter> 


SNDEDIT will append the extension .SND to this 
filename. 


You can also choose a file and other options from 
the DOS command line, with the format: 


SNDEDIT [/option] [filename] 
where option may be: 


IA Append new records or commands to 
the specified file. (Otherwise, editing 
begins at the first record.) 


/In Start at record or index number n. If 
the /A option is also used, then the /I 
option is disregarded. If neither /A nor 
/I is used, editing starts at record 1. 


/D Choose a keyboard configuration file for 
a non-U.S.A. keyboard. An example is 
/Dgermany. Using /D with no filename 
causes SNDEDIT to display a list of all 
filenames available that end in .CFS, 
from which you may choose one 
corresponding to your language. 
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Filling in the Screen 


IDEAcomm/5251 SEND Event Editor 
Copyright (c) 19xx IDEAssociates, Inc.Version x.x 


File: xxxxx.SND Record #nnn 


Session Number: 

Wait Delay 

Search String 

Event Row 

Event Column 

Send Buffer 

Display Screen 

AID Key none 


Use KEYPAD to move, TAB/BACKTAB for next/previous 
record, ESCAPE to exit 


Figure D-1: Record Screen of the SEND File Editor 


One screen represents one record or command. 
You may use 100 records. You may insert or 
delete records, with automatic renumbering, by 
pressing the Ins or Del keys. Fill in the fields in 
order from left to right and top to bottom. When 
all fields on a screen are filled, a new blank 
Screen-record appears. Home and End, as well as 
the arrow keys, allow you to move over the record. 


To end, press Esc. A prompt asks whether to save 
the file. Answer Y to save your entries. 


The following fields appear for each record: 


Session Number: Enter the LU number (1 
through 4 or 1 through 7) for which this 
file will be used. 


Wait Delay: This is the number of seconds to wait 
for a particular search string to happen. 
If the event occurs within this limit, the 
SEND utility will process the record; 


The SEND File Editor D-3 


otherwise it will terminate. Possible 
entries are 0 through 255 seconds. The 
delays that you must allow vary with 
your system’s speed and the speed of 
your application. In particular, text 
searches in word processing applications 
may require many seconds. 


Search String: This is the string to check for in 
the emulation display before processing 
any more. An example is a host 
prompt. 


There cannot be any spaces in the 
search string. Upper and lower case 
must match the screen display. 


Note 


If only one entry is needed on a screen, 
you do not have to fill in the Search String, 
Event Row, and Event Column. 


Row and Column: Enter the position on the 
screen in which the search string or host 
prompt should begin. Possible entries 
for row are 1 to 24 (1 to 27 for a 3180 
display type), and for a column, 1 to 80 
or 1 to 132. 


Send Buffer: This is the command or set of 
keystrokes that you want to send in 
response to the previous search string. 


To enter an emulated key, press Alt—P 
for a list of these keys: Cent, Field— 
Error Reset, and so on. Note that only 
those Keys that do not cause an Input 
Inhibited state are allowed. Use the 
cursor keys to move the highlighted bar 
to your choice and press Enter. The 
name of the emulated key will appear in 
the Send Buffer line. 
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To complete the Send Buffer line, press 
Enter or use cursor arrows to move to 
other fields. 


Display Screen: Valid choices are Y and N. Y 
tells the SEND utility to display the 
screen as it would appear if emulation 
were running. This option is important 
if none of the AID (Attention 
Identification) keys listed below are sent, 
so that during emulation the user can 
see when to continue manually. For 
batch files, choose NO. 


AID Key: This tells the SEND utility which AID 
key to send once the Send Buffer has 
been sent. Press the space bar to cycle 
through choices. The AID keys are: 


None Enter 

Attn Home 

Print Help 

Roll Down Roll Up 

Error Reset Clear 

Test Req Cmd-1 through 24 
Operator 


Pause for Operator Entry: If the Operator key is 
selected, the program will pause at runtime for 
operator entry. If the AID key is NONE, the 
program will not pause. 


Size: The size of the SEND buffer is that of the 
screen (1920 bytes). This includes the AID keys 
as well as the keystrokes you type. 
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Example 


Suppose that your daily startup sequence is the 


following: 

1. You enter TWINAX and see the prompt User 
ID. 

2. You enter IDEA and press the emulated Enter 
key (Caps Lock on the PC and AT keyboards). 
That is the only entry you make in screen 1. 

3. The screen changes to a menu, with room after 
the word Ready for a command to be typed in. 
You type TEXTDOC, and press Enter. That is 
the only entry you make in screen 2. 

4. The third screen takes some time to appear. It 


is the DISPLAYWRITE menu, on which you 
make three entries. At the host prompt 
Option on row 4, column 3, you select 5. At 
the prompt Document on row 6, column 3, you 
enter MINE. At the prompt Folder on row 7, 
column 5, you enter REV. Then you press 
Enter. 


Fill out five records as shown on the next page. 


Use this file with SEND in the following steps: 


1. 


Use SNDEDIT to create a file with the default 
name TWINAX.SND. 


Start emulation with the command TWINAX 
<Enter>. 


Use the Hot Key to return to DOS (default 
Shift—Shift). 


Enter SEND <Enter>. 


You will see the sign-on menu as IDEA is 
placed in the user ID, then the second menu as 
TEXTDOC fills the command line. Then you 
will see the DISPLAYWRITE menu as the 
entries 5, MINE, and REV appear. Finally, 
you will see the DOS prompt. 
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Record 1 


Session Number: 


Wait Delay 
Search String 
Event Row 
Event Column 
Send Buffer 
Display Screen 
AID Key 


Record 3 


Session Number: 


Wait Delay 
Search String 
Event Row 
Event Column 
Send Buffer 
Display Screen 
AID Key 


Record 5 


Session Number: 


Wait Delay 
Search String 
Event Row 
Event Column 
Send Buffer 
Display Screen 
AID Key 


From the DOS prompt, press the Hot Key 
(Shift—Shift) to return to emulation. You will 
see your text file waiting for you to make 
changes. 


Record 2 

Session Number: 

Wait Delay 

Search String 

Event Row 

Event Column 001 
IDEA Send Buffer TEXTDOC 
Yes Display Screen Yes 
<Enter> AID Key <Enter> 


Record 4 
1 Session Number: 1 
010 Wait Delay 005 
Option Search String Document 
04 Event Row 
003 Event Column 
5 Send Buffer 
Yes Display Screen 
<newline> AID Key <newline> 


<Enter> 
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Appendix E: 

Using the Keyboard 
File Editor 
eee 


Overview 


The keyboard file editor, KYEDIT, allows you to 
create or remap keyboard files. It is intended for 
technical users who are creating files for languages 
not supported by IDEA’s language files, or 
customizing existing language files. 


Files Required 


KYEDIT.EXE The keyboard editor 
TWINS5251.EXC Exception code file, 
xxx.CAP Keyboard label file 

Xxx. KEY Key file for the scan codes 


sent for each key 
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Running the Program 


Strategy for Changing Keys 


1. 


WW 


Choose a .KEY file that is close to the one you 
want to create. Copy the .KEY file to a new 
name (such as AZTEC.KEY). Save the 
original file. 


You may also create a new, empty file, after 
starting the program, but this is seldom 
necessary. 


. To start the program, enter: 


KYEDIT <Enter> 


First load the .KEY file that you created and a 
-CAP file. 


Make the desired changes. Most users can 
make all ir han ing the fir reen 


and then options 1 and 2. Options 3, 6, and 7 
are designed for the experienced user who has 
a working knowledge of system internals. 
Options 4 and 5 are for IDEA developers. 


Save the configuration to disk (option 9). 
Either exit (Esc key) or edit another file. 


Before you use the changes in emulation, you 
must run IDEACFIG to select the new .KEY 
file you created or changed. 


These steps ae explained in detail on the following 
pages. 
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Getting Started 


When you invoke KYEDIT, you see a screen with 
the following options at the bottom: 


Currently Editing: ___ 


File Description: 

Enhanced Keyboard: World Trade: 
Language: Multinational: 
Version Number: Modified: 


Enter the name of key file to load, ESCAPE to cancel, 
ENTER to list files 


Figure E-1: KYEDIT First Menu (no defaults) 


These options are explained under the heading 


Load Keyboard Language File on the next page. 


The top half of the KYEDIT screen, once a 
language file is selected, offers the following 
options: 


1. Load Keyboard Language File 
Remap Keyboard Using Key Labels 
Remap Keyboard Using Scan Codes 
Advanced Keyboard Customization 
Display Key Definition 

Edit Display Translation Table 
Edit Printer Translation Table 
Reset Keyboard Configuration 

. Save Configuration to Disk 

Esc. Exit KYEDIT 


Figure E-2: KYEDIT Main Menu (Top Half) 


CHAAKH AWD 


These options are described in the rest of this 
appendix, except for options 4 and 5, which are 
reserved for IDEA Technical Support. (Option 4 
allows display of the table that is edited with Option 
3.) 
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1. Load Keyboard Language File 


When you select option 1 or first invoke KYEDIT, 
the cursor moves to the bottom part of the screen 
shown on the previous page. 


Currently Editing: You may enter a new or 
existing filename or pathname. If you type a 
filename with no extension and press Enter, the 
software immediately adds the extension .KEY to 
this file. 


If you want to edit an existing file, instead of 
entering a filename, press Enter again for a display 
of available files (these all end in .KEY). You get 
a list of key files in the current directory, similar to 
the following: 


BAT.KEY 
BENH.KEY 
BPC. KEY 
CHAT. KEY 
DKAT.KEY 
GAT. KEY 
AZTEC. KEY 
etc 


where B stands for Belgian, C for Swiss/German, 
DK for Danish, G for German, AT for the AT 
keyboard layout, ENH for the enhanced keyboard 
layout, and so on. 


Use the cursor keys to move the lighted bar to the 
file you want, then press Enter. You see a new 
screen with a list of .CAP files, and the prompt: 
A:\ 

Use ARROWS to choose file, ENTER to select, 
or ESCAPE to cancel 


A:\ indicates the path where key files are sought. 


The CAP file contains the name and definition of 
each key. Select a .CAP file with the cursor keys 
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and press Enter. The bottom of the screen now 
shows: 


Currently Editing: A:\AZTEC. KEY 

File Description: Belgium, AT 

Enhanced Keyboard: No World Trade: Yes 
Language: . Belgium Multinational: No 
Version Number: 1.02 Modified: No 


Enter the name of key file to load, ESCAPE to cancel, 
ENTER to list files 


Figure E-3: KYEDIT First Menu Filled In 


You may then go through each of the items on the 
bottom of the screen (by pressing Enter if there are 
no changes), or press Esc to start selecting options 
from the top half of the screen. Note that, if you 
leave the bottom of the screen with Esc, you 
cannot return to this area without re-entering all 
options and descriptions from the beginning. 


File Description; Type a brief description and 
press Enter. 


Enhanced Keyboard: To indicate Yes for No for 
Enhanced keyboard, press the space bar and then 
Return. If you choose Yes, the screen then 
prompts for a pre-scan code. For IBM Enhanced 
keyboards, this code is EQ. Consult your keyboard 
manual or manufacturer for this information. 


Language: Use the space bar to cycle through 
choices. If you select Other, you see a request for 
IBM keyboard ID byte: 


Please enter the language byte (Hex). 


The possible values for this byte are listed by IBM 
in the publication 5250 Information Display System 
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to System 36 and System 38 System Units Product 
Attachment Information. This byte, which may 
vary with the release of IBM software, is listed in 
the March, 1987 edition as byte 3 of the Model ID 
(Extended ID information). 


Version Number: The version number of KYEDIT 
is displayed by the system. 


World Trade: Set this option to Yes if you have a 
non-U.S.A. keyboard. 


Multinational: Set this option to Yes if you have 
a non—-U.S.A. keyboard. 


After entering the language byte, you do not have 
the option of changing the World Trade or 
Multinational options. 


Modified: If you made changes, the system 
changes this display to YES. 
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2. Remap Keyboard Using Key Labels 


When you select option 2 from the main screen, 
you are prompted for the PC key you want to 
redefine. Press the key (for example, left arrow). 


For the key you are editing, you see the following 


choices: 

Normal Keypad 4 

Shift 

Control VIEW LEFT 
Control-Shift VIEW _LEFT 

Alt BORDER LEFT 
Alt-Shift BORDER RIGHT 


Control-Alt 
Control—Alt-Shift 
Hot Key Not a hot key or hot button 


Move the cursor arrow to the line with the state 
that you want to redefine, for example, Ctrl—Alt-. 
Press Enter. Then use the cursor arrows on the 
bottom part of the screen to select the name of the 
emulated key that you want to represent with 
Ctrl—Alt—left—arrow, for example, PRINT SCREEN. 
(Keys are listed on the next page.) Press Return. 


Normal 

Shift 

Control 
Control-Shift 

Alt 

Alt-Shift 
Control-Alt 
Control—Alt-Shift 


Hot Key Not a hot key or hot button 


ATTN] CMD | INSERT PRINT |HELP| CURSOR| CURSOR 
KEY | KEY | KEY UP DOWN 


MORE | 


Use ARROWS to choose label, ENTER to select, 
or ESCAPE to cancel 


Figure E-4: Key Label Editing 
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Attn Cmd Cursor Up |Cursor Dn 


7 


|Dup 
u 
C 


e 
lu 
Num. m.8 _ ielc [Caps Lock |a sid 
f fe Meee eee 
Left Brace 
x Ok es ll 
Slash 
Num.0 
Tilde [Line Bar _ 
Asterisk 
R 
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iN 
Cmd3 
Cmd1i 
md1& mdi9_ md20 |Cmd21 __ |Cmd22._| mc mdZ4 
lear buff | Ctrl-C _| Ctrl-Break | Reboot _| Toggle LU | Exi 


oggle LUs| Excptn 0A* 


= ® ra i) 


GN 


Backsp 
Field Exit 


Quote 


N 


Period 
Enter/RecAdv 
Roll Down 
Apostrophe 


A 


de | Toggle Windov 


Borde 5 


View Rt | View Left |View Up Dn 
Border Up Playback Excptn 18° 


PrintScreen *Reserved 


Figure E-5: Options on the Key Label Screen 
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Note 


In this appendix, a Hot Button is the 
equivalent of the IDEA Hot Key, which 
switches between the current LU and DOS and 
makes emulation resident. A Hot Key is the 
IBM Hot Key, which cycles through all LUs 
and then to DOS. IDEA supports both 
methods for user flexibility. 


You may set up any number of Keys as Hot 


Buttons. 

Examples | 

To change the Hot Button (Shift-Shift) to 

Ctrl-F4: 

1. From the main menu, select option 2. 

2. Press the key you wish to change (F4) 

3. Set F4 as a Hot Button (Option 9). Use the 
space bar until Hot Button appears, then press 
Enter. 

4. Press Esc to complete this remapping. 

5. Press Ctrl. 

6. Set Ctrl as a Hot Button. 

7. Press Esc to complete this remapping, Esc again 
to leave option 2, answer NO to Do you wish 
to edit the ESCAPE key?, and press 9 to save 
your changes. 

8. Run IDEACFIG to incorporate the new key file 


into the configuration file. 


F4 and Ctrl may still have other function in various 
States. When both are pressed consecutively, 
however, they work as the Hot Button, alternating 
between DOS and the current LU. 


Examples are on the next page. 
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To set Enter as the emulated Enter key: 


Enter in the default state is the emulated Field Exit 
key, so you might change Field Exit to 
Shift-numeric plus. 


1. 


2 
3. 
4 


WN 


From the main menu, select option 2. 
Press the + Key on the numeric Keypad. 
Select 2 (Shifted state) and press Enter. 


On the lower half of the screen, select Field 
Exit and press Enter. 


Press Esc to start editing a new key. 
Press the Enter key. 


Move the lighted bar to 1 (Normal) and press 
Enter. 


On the lower half of the screen, select — 
Enter/RecAdv and press Enter. 


. Press Esc twice and answer No to the prompt, 


Do you wish to edit the ESCAPE key? Press 
9 to save your changes. 


10. Run IDEACFIG to incorporate the new key file 


into the configuration file. 


To set Alt-F3 as the Clear key: 


Le 


2 
3. 
4 


From the main menu, select option 2. 
Press the key you wish to change (F3) 
Select Option 5 (Alt state) and press Enter. 


From the list of emulated keys that appears in 
the lower half of the screen, select Clear and 
press Return. 


. Press Esc twice and answer No to the prompt, 


Do you wish to edit the ESCAPE key? Press 
9 to save your changes. 


Run IDEACFIG to incorporate the new ie file 
into the configuration file. 
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3. Remap Keyboard Using Scan 
Codes 


This option allows technical users with a knowledge 
of system internals to change key configurations. 
The “Codes Sent” can be found in the IDEA 
Technical Reference Manual, or in the IBM System 
documentation. 


When you select option 2 from the main screen, 
you are prompted for the PC key you want to 
redefine. Press the key (for example, G). For the 
key selected, you see the following choices: 


Keyboard Description: xxxx Keyboard 
Ojiting an sequence: 46 

Typematic 

Send code after release if no other key pressed 
Send code for both press and release of key 
Send multiple characters for key 
Exception Code 
Special Status Bit 
Mask is a toggle 


Normal 000000000 
Shift 000000000 
Ctrl 000000000 
Ctrl-Shift 000000000 
Alt 000000000 
Alt-Shift 000000000 


Ctrl-Alt 000000000 
Ctrl-Alt-Shift 000000000 


ZZZZZZZZ 
ZZZZZZZZ 
ZZLAMRZ ZN 


Use ARROWS to position cursor, Enter a 2 byte HEX code, 
ESCAPE to cancel 


Figure E-6: Scan Code Table 


Typematic: Y means that this key is processed 
repeatedly until it is released or another key is 
pressed. For example, you could send out a string 
of asterisks by holding down the * key if it is 
marked as typematic. 


Send code after release if no other key pressed: 
Y means that the code is sent only if the key 
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combination in question is pressed and released 
while no other key is pressed. This option and the 
following one are mutually exclusive. 


Send code for both press and release of key: Y 
means that this key is to be processed both on the 
press of the key and on its release. An example is 
the Shift key. This option and the preceding one 
are mutually exclusive. 


Send multiple characters for key: Y means that 
this key generates more than one code to be sent 
to the host (as shown in the Codes Sent field). 
For example, to send shift-D, you would send 57 
13 D7 (Shift-D-End-Shift). Enter both codes in 
the Codes Sent fields. To send CMD 1, send 6F 
31. 


Exception Code: Y means that pressing this key 
combination sends one of the following exception 
codes to the emulation program, which processes 
them without forwarding them to the host. 


Exception Codes 


1H Clear Buffer — 10 Move window border left 
2 Reserved 11 Move window border up 
3 Reserved 12. Move window border down 
4 Reboot 13. Record keys 
5 Cycle through LUs 14 Playback keys 
6 Exit TWINAX 15 Cancel record keys 
7 Reset microcode 16 Erase record keys 
8 Window mode on/off 17 Reserved 
9 Toggle active LU 18 Reserved 
| A Reserved 19 ~=Print Screen 
B Scroll one character right 1A Cycle between 132 and 80 
C Scroll one character left character display 
D Scroll one row up 1B Scroll left 
E Scroll one row down 1C Scroll right 
r Move window border right one 1D Scroll up 


position Scroll down 


Special Status Bit: Y means that this key sends 
out a NULL code if no exception code has been 
specified, regardless of codes in the Codes Sent 
field. 
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Mask is a Toggle: for use by IDEA developers. 


Codes Sent: shows which 5250 scan codes will be 
sent to the host when this key is pressed. (Scan 
codes are listed in Appendix X.) 


Shift Mask: for use by IDEA developers. 


6. Edit Display Translation Table 


This option allows you to make permanent changes 
in the ASCII translation tables. It is different than 
the option in IDEACFIG (which changes only 
TWINAXn.UCM) because it makes permanent 
changes to the tables that are not overwritten with 
different files. 


Change this table only if your system administrator 
notifies you that the host system is sending unusual 
characters (such as foreign language characters). 


Use the arrow keys to move the cursor to the 
EBCDIC character whose ASCII translation you — 
want to change. Enter the new ASCII code and 
press Return. Repeat this process from the main 
screen for each character you want to change. 


For example, you might want to change the 
appearance of the character that the host is sending 
as EBCDIC 5B (dollar sign) to ASCII 9C (British £ 
pound sign). ASCII charts are in Appendix A. 


7. Edit Printer Translation Table 


This works the same as the Display Translation 
table. If your printer is unable to print a symbol 
such as £ that is sent by the host, you can change 
its translation to a symbol such as # that is available 
on most printers. ASCII charts are in Appendix A. 


8. Reset Keyboard Configuration 


Use this option if you wish to cancel a 
configuration. The loaded table reverts to the last 
file loaded or saved, whichever happened later. 
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9. Save Configuration to Disk 


This saves the current information as keyfile. KEY, 
the name you chose on the first screen. 


Options with the KYEDIT 
Command 

You can use options with the KYEDIT command: 
KYEDIT [keyfile [capsfile |] 


where KEYFILE is the name of the keyboard 
emulation file ending in .KEY and CAPSFILE is 
the name of the key caps label file for this type of 
emulated keyboard, ending in CAP. 


For example, 
KYEDIT USENH US_ <Enter> 


edits the USENH.KEY file using the US.CAP file. 


If the program cannot find either of these two files, 
then the default setting is loaded, using the 
equivalent of the USPC.KEY file for the PC/XT 
and AT keyboards, and the USENH.KEY file for 
the Enhanced keyboard. 
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The .CAP File Structure 


The KYEDIT program reads CAP files. You 
should not try to change these files. If you want to 
look at a CAP file, such as US.CAP, you can use 
the TYPE command of DOS, or print the file. Its 
structure is the following: 


Typematic Send on Press Send on Key Cap Scan Comment 
and Release Release Label Codes 
Reman. ©) ON) .< -)' aeRENe © 2 0 | | Nees ee ele eee es ee 


Examples: 

N N N ‘Attn’ 7C ; Key 1 

N N Y ‘Caps Lock’ 54 D4 ; Key 45 

Shifted State Examples: 

N N N ’Sys Req’ $77C D ; Keyl 
Shifted 

Y N N ’Letter P; 57 2A D7; Key 37 
Shifted 


The “Key” is the key position shown in the 
Technical Reference Guide. 


Using the Key Editor E-15 


Appendix F: 
Glossary 


AID 
Attention Identification key that sends control 
messages to the host. 


ASCII 

American Standard Code for Information 
Interchange, a coding scheme wherein letters, 
numbers, and special symbols are represented as 
unique seven—bit values, allowing for standardization 
between data communications devices. The IBM 
PC and PS/2 use ASCII. 


Backup 
A duplicate copy of data. 


Batch File 

A file that contains commands. It is faster to run 
than retyping the commands each time. Such 
filenames, if intended for use with DOS, end with 
the extension .BAT. Batch files for use with 
IDEAcomm’s SEND utility end in .SND. 

Bit 

Abbreviation for binary digit. A bit is the smallest 
unit of information recognized by a computer, 
expressed as the digits 1 or 0. 


Bits per second (bps) 
The bit speed with which a device or channel 
transmits a character. 


Board 

In this manual, board and card are used 
interchangeably for the small printed circuit boards 
that can be added to the IBM PC or PS/2 family. 
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Boot 
To bring up or restart the microcomputer. 


Bootable 

Used of a partition or disk to which command 
transfers at startup time. A diskette or partition is 
bootable if it contains the DOS files that will start 
the operating system when the IBM is powered on. 


Buffer 
Temporary storage for characters that need to be 
collected prior to processing. 


Card 

In this manual, card and board are used 
interchangeably for the small printed circuit boards 
that plug into the IBM. 


Disk operating system (DOS) 
An operating system for the IBM PC and PS/2 
series of computers. 


EBCDIC 

Extended Binary Coded Decimal Information Code, 
a coding scheme wherein letters, numbers and 
special symbols are represented as unique six—bit 
values, allowing for standardization between data 
communications devices; used by IBM midrange. 


Emulation 

The ability to make a host computer (such as the 
IBM midrange) recognize a microcomputer as one 
of its own terminals, printers, or other devices. 


Driver 
Software that controls a device. 


Free key mode 
State of a PC or PS/2 not varied on by the host. 


Host computer 

Primary or controlling computer in a multiple 
computer system upon which the smaller computers 
depend to allocate the resources of the system. In 
this manual, host refers to the AS/400 or to the 
System 34, 36, or 38. 
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Hot Key 

A key combination that provides the ability to cycle 
between PC-DOS applications and emulation 
without having to log off of the host. The IDEA 
Hot Key (default Shift—Shift) makes emulation 
resident and moves directly from the current 
session to DOS and back. 


K or KB 
Abbreviation for kilobyte: 1,024 bytes (characters) 
of information. 


LU 
Logical Unit, an emulated host session or device. 


M or MB 

Abbreviation for megabyte (1 million bytes or 1024 
KB). 

Midrange 

The IBM System 34, 36, 38, or AS/400 


Offline 
Used of communications devices not using a 
communications medium. 


Online 
Used of communications devices physically 
connected to and using a communications medium. 


Parallel port 

Interface located on a host adapter card used for 
connection with a parallel device such as a printer 
or mouse. It provides parallel transmission, which 
is simultaneous transmission of all bits in a byte. 


Parity 

Checking of whether the sum of bits is odd or 
even. The integrity of each character read or 
transmitted can be tested by generation and 
subsequent checking of character parity. 


Peripheral 

A noncomputing input or output device, such as a 
printer or hard disk drive. 

Port 

A connection that allows communications between 
the IBM and another device. 
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Protocol 
Rules by which to exchange information, including 
the organization of units of data to be transferred. 


Resident 
Used of a program that is in live memory. 


Serial port 

Common serial communications interface used by 
devices such as modems and laser printers. It 
allows serial transmission, whereby data is sent in a 
regular pattern of bits. 


Station address 
A unique address in the range of 0-6. It identifies 
a system terminal or printer on the TWINAX cable 
run to the host. 


System 3X 
The IBM System/34, /36, or /38. 


TWINAX 

The IDEA emulation program or card. Twinaxial 
cable is a type of cable used in IBM midrange 
installations. 


TWINAX run 
A series of one or more devices all on the same 
twinaxial cable that connects to the controller. 


Typematic 
Repeating; keys such as the alphabet keys on a 
keyboard will repeat when held down. 


Varied on 

Recognized as ON or set ON by the host. The PC 
or PS/2 as an emulated terminal must be varied on 
by the host before the host will accept data from it. 


Virtual disk or virtual floppy 
Memory that appears to DOS as a single disk but is 
implemented by some other means. 
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Appendix G: 
Customer Support 
Information 


Telephone Support 


If you have any problems using our product, please 
follow these steps before contacting our technical 
support staff. 


Ls 


Make sure your computer system meets all the 
hardware requirements listed in the manual. 


Referring to your manual, carefully check all 
the cables to make sure they are connected 
correctly. 


Complete the following checklist: 


Software name 
Serial number 
Version number 


Computer brand name 

Model number 

RAM (memory) bytes 
Operating system (name and version, e.g., 
P.C.—DOS version 2.0) 


@ Manufacturer and model number of: 


Video adapter board 
Printer/Plotter 
Expansion RAM board 
Hard disk system 
Modem 

Other 
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Be sure you can answer the following questions: 


— Did the program ever work properly? If so, 
have you changed anything in your 
operating environment? 


— Did any error messages appear? If so, what 
were they? 


- What is the exact sequence of steps 
required to produce the problem? 


With your computer on and the software 
loaded, call the number where you bought the 
product, or IDEA Technical Support at the 
number below. 


Repair Policy 


If your product is still under the original one year 
limited warranty, IDEA will repair or replace it at 
no charge. If the product is out of the warranty 
period, IDEA will repair it and charge you on a 
time and materials basis. 


If you are having problems with your IDEA 
product, take the following steps: 


1. 


2: 


Go through the checklist above. 


Call the IDEA Technical Support Department 
at (800) 343-0056. In Massachusetts, call 
(508)-—663-6878. (Be sure that you have the 
serial numbers from your software diskette and 
from your IDEA hardware.) If the Technical 
Support representative determines that your 
product requires factory service, you will be 
issued a Materials Return Authorization (MRA) 
number. IDEA will not accept returned 
products without an MRA number. 


Box the product in the original shipping 
container or other secure package. Write your 
MRA number clearly on the outside of the box. 
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For all warranty repairs, enclose a copy of the 
original purchase receipt as proof of date of 
purchase. 


4. Ship by the most economical means to: 


IDEA, Inc. 

MRA # 

29 Dunham Road 
Billerica, MA 01821 


Once your product has been repaired, IDEA will 
return it to you by UPS or the most economical 
carrier at IDEA’s expense. 


Warranty Card 


Please complete and promptly return the enclosed 
warranty card. The warranty card should be filed 
by the party who installs the IDEA product. 


Limited Warranty 


For IDEA’s Limited Warranty, see page iii of this 
manual. 
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Index 


Numbers 
3180 (wide screen) display, 4—5 
A 
ADDVDSK command, 7-12 
AID (Attention Identification) key, D—-5 
Alternate station address, 2-11 
Attribute appearance, B-8 
Attributes, changing, 4—10 
Attributes, displaying, 3-13 
AUTOTWIN command, 3-20 
B 
Batch files within TWINAX, 3-19 
Board defined, F—1 
Boot defined, F-2 
Bootable defined, F-2 
C 
Card defined, F-2 
Clear key, defining, E-10 
Color attribute appearance, B-12 
Color attribute mapping, 4-19 
Color attributes, changing, 4—10 
Column separator, changing, 4—18 
Command Menu, 3-12 
Condense key (CtrI-M), 4-6 
Configuration 
Changing, 2-8 
with IDEACFIG, 2-6 
with INSTALL, 2-2 
Configuration, saving, 2-19 
Configuration, viewing from emulation, 3-15 
Cursor type, changing, 4-18 
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D 
Devices, configuring, 2-9 
Diagnostics (TWINDIAG), A-15 
Display attributes, changing, 4-10 
Display, configuring, 2—9 
Displays, 4—1 
Displays, troubleshooting, A-2 
Driver defined, F—2 
E 
EBCDIC/ASCII translation, 4-14 
Emulation command TWINAX, 3-4 
Emulation, ending, 3-8 
Emulation, files, 3-2 
Error messages 
IDEACFIG, A-20 
INSTALL, 2-4 
Printer, 5-6 
TWINAX, A-18 
EXIT command from emulation, 3-16 
EXTENDED option of Command Menu, 3-13 
F 
Field attributes, displaying, 3-13 
File transfer, 7-1 
File transfer package, configuring, 2-12 
Freeing sessions, 3-13 
| G 
Glossary, F-1 
GR5292 graphics feature, 4—8 
Graphics, using, 4-8 
H 
Host Session (LU), 2-10 
Hot Key (Shift-Shift), 3-11 
Hot Key, changing, E-9 
[ 
I/O address, configuring, 2-16 
IBM transfer package, configuring, 2-12 
IDEACFIG configuration program, 2-6 
IDEAcomm 5251 and 5251/Plus features, 1-1 
INSTALL program, 2-2 
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K 
K or KB defined, F-3 
Keyboard layouts, B—-1 
Keyboard layouts, specifying, 2-18 
Keyboard remapping (KYEDIT), E-1 
Keyclick, specifying, 2-19 
Keystroke buffering, 2-13 
KYEDIT utility, E-1 
L 
Limited warranty, ili 
Local Print feature, 5-8 
Logical Units, moving between, 3-7 
M 
M or MB defined, F-3 
Memory address, configuring, 2-16 


Memory diagnostics from TWINDIAG, A-16 


Messages 
IDEACFIG, A-20 
INSTALL, 2-4 
Printer, 5—6 


TWINAX, A-18 

TWINDIAG, A-17 
Monochrome attribute appearance, B-8 

p 

Parallel (printer) port, F—3 
Parity defined, F-3 
Peripheral defined, F—3 
Playing back keystrokes, 3-17 
Port defined, F-3 
Power on reset, configuring, 2-17 
Printer Control Panel, 5-2 
Printer configuration, user-defined, 6—1 
Printer diagnostics from Control Panel, A-8 
Printer diagnostics from TWINDIAG, A-15 
Printer diagnostics, System 3X, A-8 
Printer, configuring, 2-9, 6-1 
Printer, selecting, 2-14 
Printer, troubleshooting, A—S5 
Printer, user defined, 6-1 
Printer, using, 5—1 
PrintScreen feature, 5—8 
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R 
REMVDSK command, 7-13 
REVUP program, C-1 
Record keys, saving, 3-15 
Recording keystrokes, 3-17 
Remapping color attributes, 4-10 
Remapping the keyboard (KYEDIT), E-1 
Reserving sessions, 3-14 
Reset, configuring, 2-17 
Resident feature, 3-6 
Ss 
SAVE CONFIGURATION feature of emulation, 
3-15 
SEND editor, D-1 
SEND utility, 3-19 
Serial (COM) port, F-4 
Shadow cursor, 3180, 4-7 
Station address, 2-10 
Status line, 3-9 
T 
Technical Reference Guide, ordering, 1-7 
TWINAX emulation command, 3-4 
TWINAX.UCM, updating with REVUP, C-1 
TWINDIAG program, A-14 
Typematic, defined, E-11 
U 
User Interface options of IDEACFIG, 2-16 
V 
VIEW SETUP feature of emulation, 3-15 
VIRTUAL command from emulation, 3-16 
Video adapters, 132 column, 4-6 
Virtual disk, 7-1 
Virtual disk, troubleshooting, A—5 
Ww 
Warranty, iii 
WINDOWS feature of Command Menu, 3-13 
Wide screen displays, 4-5 
Window mode, setting for startup, 4-20 
Windows, 4-1 
Windows, saving the configuration, 3-15 
Windows, troubleshooting, A—4 
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